Qt 進階教程（五十二）：拖放技術深度解析 —— 從文件拖入到文本編輯器的完整實現

編輯：關於C語言

拖放 (Drag & Drop, DnD) 核心模型

DnD = Drag (拖動) + Drop (放下)。Qt 中 QWidget 既可作 Drag Source，也可作 Drop Target，或雙重身份。系統剪貼板交換本質上也是 DnD 的特例。

事件處理流程

事件	觸發時機	典型處理
`dragEnterEvent`	拖拽對象進入組件區域	檢查 MIME 類型，`acceptProposedAction()` 允許放置
`dragMoveEvent`	拖拽對象在組件內移動	可選，精細控制視覺反饋
`dragLeaveEvent`	拖拽對象離開組件區域	可選，清理臨時狀態
`dropEvent`	用戶釋放鼠標完成放置	讀取 MIME 數據，執行業務邏輯

實戰案例：文本文件拖入讀取內容顯示

類設計

class MainWindow : public QMainWindow {
    Q_OBJECT
public:
    MainWindow(QWidget *parent = 0);
protected:
    void dragEnterEvent(QDragEnterEvent *event) override;
    void dropEvent(QDropEvent *event) override;
private:
    bool readFile(const QString &fileName);
    QTextEdit *textEdit;
};

構造函數：明確接管 Drop 權限

MainWindow::MainWindow(QWidget *parent) : QMainWindow(parent) {
    textEdit = new QTextEdit;
    setCentralWidget(textEdit);

    // 關鍵：禁止 QTextEdit 內建 Drop，由 MainWindow 統一處理
    textEdit->setAcceptDrops(false);
    setAcceptDrops(true); // MainWindow 接受 Drop

    setWindowTitle(tr("Text Editor"));
}

dragEnterEvent：MIME 類型守門員

void MainWindow::dragEnterEvent(QDragEnterEvent *event) {
    // text/uri-list 標準 MIME：文件路徑列表 (本地文件/URL)
    if (event->mimeData()->hasFormat("text/uri-list")) {
        event->acceptProposedAction(); // 顯示「可放置」光標
    }
}

dropEvent：核心業務邏輯

void MainWindow::dropEvent(QDropEvent *event) {
    QList urls = event->mimeData()->urls();
    if (urls.isEmpty()) return;

    QString fileName = urls.first().toLocalFile(); // 取首個文件轉本地路徑
    if (fileName.isEmpty()) return;

    if (readFile(fileName)) {
        setWindowTitle(tr("%1 - %2").arg(fileName).arg(tr("Drag File")));
    }
}

文件讀取輔助函數

bool MainWindow::readFile(const QString &fileName) {
    QFile file(fileName);
    if (!file.open(QIODevice::ReadOnly)) return false;
    QTextStream in(&file);
    textEdit->setText(in.readAll());
    return true;
}

關鍵技術點解析

MIME 類型體系：text/uri-list 由 IANA 定義，跨平台標準化文件引用傳遞。QMimeData 封裝了平台差異。
權限轉移：setAcceptDrops() 精確控制哪個組件響應 Drop，避免父子組件爭搶事件。
URL 到本地路徑：QUrl::toLocalFile() 自動處理 file:///path 協議轉換，跨平台安全。
多文件支援**：urls() 返回列表，實現批量拖入只需遍歷處理。

擴展方向

自定義 MIME 類型：應用內部組件間拖拽自定義對象 (需 QDataStream 序列化)
拖拽視覺反饋**：QDrag::setPixmap() 設置拖拽時跟隨游標的圖標
動作類型控制**：Qt::CopyAction / MoveAction / LinkAction 語義區分

完整 main.cpp

#include 
#include "mainwindow.h"

int main(int argc, char *argv[]) {
    QApplication a(argc, argv);
    MainWindow w;
    w.show();
    return a.exec();
}