C# 文本編輯器開發實戰（七）：控制點機制與視覺化拖曳調整

控制點設計核心概念

在開發類 Word 的文本編輯器時，圖片、表格等嵌入物件的縮放與移動是核心交互功能。這需要一套精確的「控制點」機制，讓使用者能透過滑鼠拖曳八個方向調整物件大小。本文深入解析內外控制點的座標模型與游標切換邏輯。

內控制點：嵌入物件邊框上的八個操作點

內控制點位於物件邊界矩形的四個角與四條邊的中點，編號 0 至 7，對應八種調整方向：

┌─────────────────┐
│■0 1■ 2■│
│           │
│           │
│           │
│           │
│■7     3■│
│           │
│           │
│           │
│           │
│■6 5■ 4■│
└─────────────────┘

• 0, 2, 4, 6：四角控制點，支援等比例或非等比例縮放。
• 1, 3, 5, 7：邊中點控制點，僅調整對應邊的寬或高。
• 滑鼠懸停時需依據點位切換游標（如 SizeNWSE、SizeNS 等），提供直觀視覺回饋。

外控制點：容器層級的輔助定位點

外控制點繞著物件外包矩形分佈，用於容器層級的對齊、吸附與群組操作：

■ ■ ■
┌────────────────┐
│0 1 2           │
│                │
│                │
│                │
│                │
■│7     3│■
│                │
│                │
│                │
│                │
│6 5 4           │
└────────────────┘
■ ■ ■

外控制點不直接改變物件尺寸，而是提供參考線、磁鐵吸附或群組選取輔助，提升排版精度。

實作關鍵點

1. 座標轉換：控制點座標需在文檔座標、視圖座標、螢幕座標間正確轉換。
2. 命中測試：滑鼠移動時快速判斷是否落在控制點敏感區域（建議 6~8 像素半徑）。
3. 游標管理：維護八種游標對應表，依控制點編號即時切換 Cursor.Current。
4. 拖曳邏輯：記錄按下時的初始矩形與滑鼠位置，移動時依點位類型重新計算矩形，並即時重繪。

延伸應用

此機制可擴展至旋轉控制點（第 9 個點）、多選物件的群組控制點、以及對齊參考線的動態顯示，構建專業級的排版體驗。