前話

  Qt中的拽拖操作詳細介紹。

Demo

圖片拽拖

控制項拽拖

窗口拽拖

拽托框架（高級開發）

拖放（Drag and Drop）

  拖放提供了一種簡單的可視機制，用戶可以使用它在應用程式之間和內部傳輸資訊。拖放的功能類似於剪貼板的剪切和粘貼機制。
  本文檔描述了基本的拖放機制，並概述了在自定義控制項中啟用該機制的方法。許多qt的控制項也支援拖放操作，例如項目視圖和圖形視圖框架，以及為qt小部件和qt quick編輯控制項。有關項目視圖和圖形視圖的詳細資訊，請參見使用項目視圖和圖形視圖框架的拖放。

拖放類

  這些類處理拖放和必要的mime類型編碼和解碼。
  

配置

  QStyleHints對象提供了一些與拖放操作相關的屬性：

• QStyleHints::startDragTime()：描述在開始拖動之前，用戶必須在對象上按住滑鼠按鈕的時間量（毫秒）。
• QStyleHints::StartDragDistance()：表示在移動被解釋為拖動之前，按住滑鼠按鈕時用戶必須移動滑鼠的距離。
• QStyleHints::StartDragVelocity()：表示用戶移動滑鼠開始拖動的速度（以像素/秒為單位）。值為0表示沒有這樣的限制。
    如果在控制項中提供拖放支援，這些數量將提供與基礎窗口系統兼容的合理默認值，供您使用。

在Qt Quick種的拖放

  文檔的其餘部分主要關注如何在C++中實現拖放。要在Qt快速場景中使用拖放，請閱讀Qt Quick拖放、DragEvent和DropArea項的文檔，以及Qt快速拖放示例。

拖曳（Dragging）

  要開始拖動，請創建一個QDrag對象，並調用其exec()函數。在大多數應用程式中，只有在按下滑鼠按鈕並移動游標一定距離後，才能開始拖放操作。但是，啟用小部件拖動最簡單方法是重新實現小部件的mousePressEvent()，並啟動拖放操作：
  
  儘管用戶可能需要一些時間來完成拖動操作，但就應用程式而言，exec()函數是一個帶有多個值之一的阻塞函數。這些說明操作是如何結束的，下面將詳細介紹。
  注意，exec()函數不會阻塞主事件循環。
  對於需要區分滑鼠單擊和拖動的小部件，重新實現小部件的mousePressEvent()函數以記錄拖動的開始位置是很有用的：
  

  稍後，在mouseMoveEvent()中，我們可以確定是否應該開始拖動，並構造一個拖動對象來處理該操作：
  

  這種特殊的方法使用QPoint::manhattanlength()函數粗略估計滑鼠單擊位置和當前游標位置之間的距離。此函數以精度換取速度，通常適用於此目的。

放下（Dropping）

  要能夠接收小部件上丟棄的媒體，請為小部件調用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來註冊。