前話
Qt中的拽拖操作詳細介紹。
拖放提供了一種簡單的可視機制，使用者可以使用它在應用程式之間和內部傳輸資訊。拖放的功能類似於剪貼簿的剪下和貼上機制。
本文件描述了基本的拖放機制，並概述了在自定義控制元件中啟用該機制的方法。許多qt的控制元件也支援拖放操作，例如專案檢視和圖形檢視框架，以及為qt小部件和qt quick編輯控制元件。有關專案檢視和圖形檢視的詳細資訊，請參見使用專案檢視和圖形檢視框架的拖放。
這些類處理拖放和必要的mime型別編碼和解碼。
QStyleHints物件提供了一些與拖放操作相關的屬性：
- QStyleHints::startDragTime()：描述在開始拖動之前，使用者必須在物件上按住滑鼠按鈕的時間量（毫秒）。
- QStyleHints::StartDragDistance()：表示在移動被解釋為拖動之前，按住滑鼠按鈕時使用者必須移動滑鼠的距離。
- QStyleHints::StartDragVelocity()：表示使用者移動滑鼠開始拖動的速度（以畫素/秒為單位）。值為0表示沒有這樣的限制。
如果在控制元件中提供拖放支援，這些數量將提供與基礎視窗系統相容的合理預設值，供您使用。
文件的其餘部分主要關注如何在C++中實現拖放。要在Qt快速場景中使用拖放，請閱讀Qt Quick拖放、DragEvent和DropArea項的文件，以及Qt快速拖放示例。
要開始拖動，請建立一個QDrag物件，並呼叫其exec()函式。在大多數應用程式中，只有在按下滑鼠按鈕並移動游標一定距離後，才能開始拖放操作。但是，啟用小部件拖動最簡單方法是重新實現小部件的mousePressEvent()，並啟動拖放操作：
儘管使用者可能需要一些時間來完成拖動操作，但就應用程式而言，exec()函式是一個帶有多個值之一的阻塞函式。這些說明操作是如何結束的，下面將詳細介紹。
注意，exec()函式不會阻塞主事件迴圈。
對於需要區分滑鼠單擊和拖動的小部件，重新實現小部件的mousePressEvent()函式以記錄拖動的開始位置是很有用的：
稍後，在mouseMoveEvent()中，我們可以確定是否應該開始拖動，並構造一個拖動物件來處理該操作：
這種特殊的方法使用QPoint::manhattanlength()函式粗略估計滑鼠單擊位置和當前游標位置之間的距離。此函式以精度換取速度，通常適用於此目的。
要能夠接收小部件上丟棄的媒體，請為小部件呼叫setAcceptDrops(true)，並重新實現dragEnterEvent()和dropEvent()事件處理程式函式。
例如，以下程式碼啟用了QWidget子類的建構函式中的Drop事件，從而可以有效地實現Drop事件處理程式：
dragEnterEvent()通常用於通知qt小部件接受的資料型別。如果要在DragMoveEvent()和dropEvent()的重新實現中接收QDragMoveEvent或QDropEvent，則必須重新實現此函式。
報錯
下面的程式碼顯示如何重新實現DragEnterEvent()，以告訴拖放系統我們只能處理純文字：
dropEvent()用於解包丟棄的資料，並以適合您的應用程式的方式對其進行處理。
在以下程式碼中，事件中提供的文字將傳遞給QTextBrowser，QComboBox將填充用於描述資料的mime型別列表：
在這種情況下，我們接受建議的操作，而不檢查它是什麼。在實際應用程式中，可能需要從dropEvent()函式返回，而不接受建議的操作，或者在操作不相關的情況下處理資料。例如，如果我們不支援到應用程式中外部源的連結，我們可以選擇忽略Qt::LinkAction操作。
也可以忽略提議的操作，並對資料執行其他操作。為此，我們將在呼叫accept()之前使用Qt::dropAction中的首選操作呼叫事件物件的setDropAction()。這樣可以確保使用替換刪除操作而不是建議的操作。
對於更復雜的應用程式，重新實現dragMoveEvent()和dragLeaveEvent()將使小部件的某些部分對放置事件敏感，並使您能夠更好地控制應用程式中的拖放。
某些標準Qt小部件為拖放提供了自己的支援。在對這些小部件進行子類化時，除了DragCenterEvent()和DropEvent()之外，可能還需要重新實現DragMoveEvent()，以防止基類提供預設的拖放處理，並處理您感興趣的任何特殊情況。
在最簡單的情況下，拖放操作的目標將接收正在拖動的資料的副本，源將決定是否刪除原始資料。這由CopyAction操作描述。目標還可以選擇處理其他操作，特別是MoveAction和LinkAction操作。如果源呼叫QDrag::exec()，並返回MoveAction，則如果源選擇刪除任何原始資料，則該源將負責刪除。不應刪除源小部件建立的QMimeData和QDrag物件-它們將被Qt銷燬。 目標負責獲取在拖放操作中傳送的資料的所有權；這通常通過保留對資料的引用來實現。
如果目標理解LinkAction操作，它應該儲存自己對原始資訊的引用；源不需要對資料執行任何進一步的處理。拖放操作的最常見用法是在同一個小部件中執行移動；有關此功能的詳細資訊，請參閱有關拖放操作的部分。
拖動操作的另一個主要用途是在使用引用型別（如text/uri-list）時，其中拖動的資料實際上是對檔案或物件的引用。
拖放不限於文字和影像。任何型別的資訊都可以在拖放操作中傳輸。要在應用程式之間拖動資訊， 應用程式必須能夠相互指示可以接受哪些資料格式以及可以生成哪些資料格式，這是通過使用mime型別實現的。 由源構造的QDrag物件包含一個用於表示資料的mime型別列表（從最合適的到最不合適的順序排列），drop目標使用其中一個來訪問資料。對於常見的資料型別，便利函式處理透明使用的mime型別，但是對於自定義資料型別，必須顯式地宣告它們。
要對QDrag便利功能未涵蓋的資訊型別執行拖放操作，第一步也是最重要的一步是查詢適當的現有格式：Internet分配號碼管理局（IANA）在資訊科學研究所（ISI）提供了MIME媒體型別的分層列表。使用標準的mime型別可以最大限度地提高應用程式與其他軟體現在和將來的互操作性。
要支援其他媒體型別，只需使用setData()函式設定QMimeData物件中的資料，提供完整的mime型別和以適當格式包含資料的QByteArray。以下程式碼從標籤中獲取QPixmap，並將其儲存為QMimeData物件中的可移植網路圖形(PNG)檔案：
對於這種情況，我們可以簡單地使用setImageData()來提供各種格式的影像資料：
在這種情況下，QByteArray方法仍然很有用，因為它可以更好地控制QMimeData物件中儲存的資料量。
請注意，在項檢視中使用的自定義資料型別必須宣告為元物件，並且必須實現它們的流運算子。
在剪貼簿模型中，使用者可以剪下或複製源資訊，然後貼上它。同樣，在拖放模型中，使用者可以拖動資訊的副本，也可以將資訊本身拖動到新位置（移動資訊）。拖放模型對於程式設計師來說還有一個額外的複雜之處：在操作完成之前，程式不知道使用者是否想要剪下或複製資訊。在應用程式之間拖動資訊時，這通常沒有什麼區別，但在應用程式中，檢查使用了哪個放置操作是很重要的。
可以為一個小部件重新實現mouseMoveEvent()，並通過可能的拖放操作組合啟動拖放操作。例如，可能希望確保拖動始終移動小部件中的物件：
如果資訊被放到另一個應用程式中，exec()函式返回的操作可能預設為copyAction，但是如果資訊被放到同一個應用程式中的另一個小部件中，我們可能會獲得不同的drop操作。
可以在小部件的dragMoveEvent()函式中篩選建議的放置操作。但是，可以接受DragEnterEvent()中所有建議的操作，並讓使用者稍後決定要接受哪個操作：
當小部件中發生放置時，將呼叫DropEvent()處理程式函式，我們可以依次處理每個可能的操作。首先，我們在同一個小部件中處理拖放操作：
在這種情況下，拒絕處理移動操作。接受的每種型別的跌落動作都會進行相應的檢查和處理：
注意，在上面的程式碼中檢查了單獨的放置操作。如上所述，在覆蓋建議的操作部分，有時需要覆蓋建議的刪除操作，並從可能的刪除操作中選擇不同的操作。為此，需要檢查事件的possibleActions()提供的值中是否存在每個操作，使用setDropAction()設定Drop操作，並呼叫accept()。
小部件的dragMoveEvent()可用於通過僅在游標位於這些區域內時接受建議的放置操作來限制小部件的某些部分的放置。例如，當游標位於子小部件（DropFrame）上時，以下程式碼接受任何建議的放置操作：
如果您需要在拖放操作期間提供視覺反饋、滾動視窗或任何適當的操作，也可以使用DragMoveEvent()。
應用程式還可以通過將資料放在剪貼簿上進行通訊。要訪問這個，您需要從QApplication物件獲取一個QClipboard物件。
QMimedata類用於表示在剪貼簿中傳輸的資料。要將資料放在剪貼簿上，可以使用setText()、setImage()和setPixmap()方便函式來處理常見的資料型別。這些函式與在QMimedata類中找到的函式類似，只是它們還帶有一個控制資料儲存位置的附加引數：如果指定了剪貼簿，則資料將放置在剪貼簿上；如果指定了選擇，則資料將放置在滑鼠選擇中（僅在x11上）。預設情況下，資料放在剪貼簿上。
例如，我們可以使用以下程式碼將QLineEdit的內容複製到剪貼簿：
具有不同mime型別的資料也可以放在剪貼簿上。構造一個qmimedata物件，並使用setData()函式按照前面部分描述的方式設定資料；然後可以使用setmimedata()函式將該物件放到剪貼簿上。
QClipboard類可以通過其dataChanged()訊號通知應用程式它所包含的資料的更改。例如，我們可以通過將此訊號連線到小部件中的插槽來監視剪貼簿：
連線到此訊號的插槽可以使用可用於表示該訊號的MIME型別之一讀取剪貼簿上的資料：
selectionChanged()訊號可用於x11以監視滑鼠選擇。
在x11上，使用公共XDND協議，而在Windows Qt上使用OLE標準，而Qt for MacOS使用Cocoa拖動管理器。在x11, XDND使用MIME，因此不需要翻譯。無論平臺如何，QT API都是相同的。在Windows上，支援MIME的應用程式可以使用MIME型別的剪貼簿格式名稱進行通訊。一些Windows應用程式已經為其剪貼簿格式使用了MIME命名約定。
用於轉換專用剪貼簿格式的自定義類可以通過在Windows上重新實現QwinMime或在MacOS上重新實現QMacPasteboardMime來註冊。