Delphi 調用 WinAPI：輸入光標相關函數實戰（四）

實作簡易文字編輯器：光標控制與鍵盤輸入

本範例示範如何結合 CreateCaret、SetCaretPos、ShowCaret/HideCaret 等 API，在表單上實作一個基本的文字輸入區域。使用者可點擊表單任意位置建立插入點，並透過鍵盤輸入文字、退格刪除，光標會隨著文字長度自動移動。

核心邏輯

• 滑鼠按下：銷毀舊光標，於點擊座標建立新光標（高度依字型而定），記錄起始座標 (x1, y1)。
• 鍵盤按鍵：隱藏光標、重繪畫面、處理字元（退格或一般字元）、輸出文字、計算新光標 X 座標、重新顯示光標。

完整程式碼

unit Unit1;

interface

uses
  Windows, Messages, SysUtils, Variants, Classes, Graphics, Controls, Forms,
  Dialogs;

type
  TForm1 = class(TForm)
    procedure FormMouseDown(Sender: TObject; Button: TMouseButton;
      Shift: TShiftState; X, Y: Integer);
    procedure FormKeyPress(Sender: TObject; var Key: Char);
  end;

var
  Form1: TForm1;

implementation

{$R *.dfm}

var
  str: string;
  x1, y1: Integer;

procedure TForm1.FormKeyPress(Sender: TObject; var Key: Char);
var
  x2: Integer;
begin
  HideCaret(Handle);
  Repaint;
  if Key = #8 then
  begin
    if Length(str) > 0 then
      SetLength(str, Length(str) - 1);
  end
  else
    str := str + Key;

  Caption := str; // 同時顯示於標題列
  Canvas.TextOut(x1, y1, str);
  x2 := x1 + Canvas.TextWidth(str);
  SetCaretPos(x2, y1);
  ShowCaret(Handle);
end;

procedure TForm1.FormMouseDown(Sender: TObject; Button: TMouseButton;
  Shift: TShiftState; X, Y: Integer);
begin
  str := '';
  DestroyCaret;
  CreateCaret(Handle, 0, 0, Canvas.TextHeight('A'));
  SetCaretPos(X, Y);
  ShowCaret(Handle);
  x1 := X;
  y1 := Y;
end;

end.

表單定義 (DFM)

object Form1: TForm1
  Left = 0
  Top = 0
  Caption = 'Form1'
  ClientHeight = 206
  ClientWidth = 339
  Color = clBtnFace
  Font.Charset = DEFAULT_CHARSET
  Font.Color = clWindowText
  Font.Height = -11
  Font.Name = 'Tahoma'
  Font.Style = []
  OldCreateOrder = False
  OnKeyPress = FormKeyPress
  OnMouseDown = FormMouseDown
  PixelsPerInch = 96
  TextHeight = 13
end

此範例展示了輸入光標的完整生命週期管理，是理解 Windows 文字輸入機制的良好起點。