C++Builder 拖放功能實現：DockSite/DragKind/DragMode 與手動拖放事件

兩種拖放模式

• Docking (停駐/合併)：控件脫離原父容器，成為另一容器子控件（如工具列拖曳停駐）。
• Drag & Drop (拖曳放置)：資料/視覺元素從來源拖曳到目標，觸發資料傳輸或動作（如檔案複製、列表項移動）。

一、Docking 停駐：三屬性搞定工具列自由拖曳

容器 (接受停駐)：

CoolBar1->DockSite = true;  // 接受 dkDock 型別拖曳

可停駐控件 (工具列)：

ToolBar1->DragKind = dkDock;      // 停駐模式
ToolBar1->DragMode = dmAutomatic; // 自動啟動 (無需 OnDragOver 手寫)

其他 ToolBar 同理設定。編譯執行即可像 IDE 工具列一樣自由拖曳停駐。

二、手動 Drag & Drop：核心事件與流程

關鍵事件

基本範例：ListBox 項目拖曳到另一 ListBox

// 來源 ListBox1: DragMode = dmAutomatic
// 目標 ListBox2: DragMode = dmAutomatic

void __fastcall TForm1::ListBox2DragOver(TObject* Sender, TObject* Source, int X, int Y, TDragState State, bool& Accept) {
    Accept = (Source == ListBox1);  // 只接受來自 ListBox1
}

void __fastcall TForm1::ListBox2DragDrop(TObject* Sender, TObject* Source, int X, int Y) {
    if (Source == ListBox1) {
        int idx = ListBox1->ItemIndex;
        if (idx >= 0) {
            ListBox2->Items->Add(ListBox1->Items->Strings[idx]);
            ListBox1->Items->Delete(idx);  // 移動語義；複製則不刪除
        }
    }
}

進階：自訂拖曳影像 (dmManual + OnStartDrag)

void __fastcall TForm1::TreeView1StartDrag(TObject* Sender, TDragObject*& DragObject) {
    // 建立自訂拖曳物件，可攜帶資料、自訂游標
    DragObject = new TDragControlObjectEx(TreeView1);
    // 或 TDragDockObjectEx 用於 Docking
}

三、檔案/外部資料拖入應用程式

• 表單/控件 DragMode = dmAutomatic。
• OnDragOver 檢查 Source 為 TDragFileObject (C++Builder 封裝) 或處理 WM_DROPFILES。
• 更簡單：DragAcceptFiles(Handle, TRUE) + 處理 WM_DROPFILES 取得檔案列表 (DragQueryFile)。

常見問題與解決

現代替代：VCL 樣式 / FireMonkey / 自訂拖放管理器

• VCL 原生拖放功能基礎但足夠大多數場景。
• 複雜需求（多選、跨表單、動畫影像、觸控支援）可封裝 IDropTarget/IDropSource COM 介面實現完整 OLE 拖放。
• FireMonkey (FMX) 提供跨平台 OnDragEnter/Leave/Over/Drop/End 事件體系。

總結

C++Builder 拖放分為 **Docking (三屬性自動化)** 與 **手動 Drag&Drop (四大事件核心)**。工具列停駐用前者，資料傳輸/排序用後者。掌握 OnDragOver.Accept、OnDragDrop 資料移動、DragMode 選擇，即可覆蓋 90% 場景。複雜跨應用拖放請轉向 OLE Drag&Drop COM 介面。

1. 上一篇文章： C++ Builder 繪圖於 Windows 開始按鈕：GDI 跨進程繪圖實戰
2. 下一篇文章： C++Builder 任務列圖示管理：最小化到托盤與前端顯示切換

VC 教學

獲取網頁密碼框密碼的兩種 COM 接口方案

問題背景 IE 自動完成保存的密碼無法直接導出。網頁密碼框（

局域網點對點語音通訊系統實作

需求：單位內部局域網跨房間語音溝通，不依賴 NetMeeti

VC++ DLL 編程深度解析（一）：從靜態庫到動態鏈接庫的演進與核心概念建立

本系列開幕篇建立 DLL 核心認知：從「無庫 → 靜態庫 →

VC++ 6.0 實作 QQ 連連看自動消除外掛

前言 連連看類遊戲核心在於「尋找可由不超過三條直線連接的相同