QDrag Class Reference · PyQt4 中文文檔

# QDrag Class Reference ## [[QtGui](index.htm) module] 該QDrag類提供了基于MIME的拖放支持拖放的數據傳輸。[More...](#details) 繼承[QObject](qobject.html)。 ### Methods * `__init__ (self, QWidget?dragSource)` * `Qt.DropAction exec (self, Qt.DropActions?supportedActions, Qt.DropAction?defaultDropAction)` * `Qt.DropAction exec_ (self, Qt.DropActions?supportedActions?=?Qt.MoveAction)` * `Qt.DropAction exec_ (self, Qt.DropActions?supportedActions, Qt.DropAction?defaultDropAction)` * `QPoint hotSpot (self)` * `QMimeData mimeData (self)` * `QPixmap pixmap (self)` * `setDragCursor (self, QPixmap?cursor, Qt.DropAction?action)` * `setHotSpot (self, QPoint?hotspot)` * `setMimeData (self, QMimeData?data)` * `setPixmap (self, QPixmap)` * `QWidget source (self)` * `Qt.DropAction start (self, Qt.DropActions?supportedActions?=?Qt.CopyAction)` * `QWidget target (self)` ### Qt Signals * `void actionChanged (Qt::DropAction)` * `void targetChanged (QWidget *)` * * * ## Detailed Description 該QDrag類提供了基于MIME的拖放支持拖放的數據傳輸。拖放是一種直觀的方式為用戶在應用程序中各地復制或移動數據，并且被用在許多桌面環境作為一種機制來復制應用程序之間的數據。拖動和Qt中的拖放支持是圍繞該處理大部分的拖放操作的細節QDrag類。通過拖放操作要傳輸的數據被包含在一個[QMimeData](qmimedata.html)對象。這是指定的[setMimeData](qdrag.html#setMimeData)（）函數以下面的方式： ``` QDrag *drag = new QDrag(this); [QMimeData](qmimedata.html) *mimeData = new [QMimeData](qmimedata.html); mimeData->setText(commentEdit->toPlainText()); drag->setMimeData(mimeData); ``` 需要注意的是[setMimeData](qdrag.html#setMimeData)（）分配的所有權[QMimeData](qmimedata.html)反對QDrag對象。該QDrag必須在堆上與父構造[QWidget](qwidget.html)確保Qt可以拖動后清理和刪除操作已經完成。一個像素圖可以用來表示數據，而拖動操作正在進行，并將光標移動到放置目標。這個像素圖通常顯示一個圖標，表示該MIME類型正在傳送的數據的，但任何像素映像可以被設置[setPixmap](qdrag.html#setPixmap)（）。光標的熱點可以給出相對位置一個與該像素圖的左上角[setHotSpot](qdrag.html#setHotSpot)（）函數。下面的代碼位置的像素圖，使光標的熱點點，其底邊的中心： ``` drag->setHotSpot([QPoint](qpoint.html)(drag->pixmap().width()/2, drag->pixmap().height())); ``` **Note:**在X11上，像素圖可能無法跟上鼠標移動，如果熱點直接導致光標下要顯示的像素圖。源和目標部件可與發現[source](qdrag.html#source)（）和[target](qdrag.html#target)（）。這些功能通常是用來確定是否拖放操作開始和結束于相同的部件，因此，特殊的行為可以被實現。 QDrag只處理拖放操作本身。它是由開發人員來決定拖動操作開始時，以及如何QDrag對象應該被構建和使用。對于給定窗口小部件，它通常需要重新實現[mousePressEvent()](qwidget.html#mousePressEvent)確定用戶是否按下鼠標按鈕，并重新實現[mouseMoveEvent()](qwidget.html#mouseMoveEvent)檢查一個QDrag是否是必需的。 * * * ## Method Documentation ``` QDrag.__init__ (self, QWidget?dragSource) ``` 該_dragSource_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。構造一個新的拖動對象通過指定的窗口小部件_dragSource_。 ``` Qt.DropAction QDrag.exec (self, Qt.DropActions?supportedActions, Qt.DropAction?defaultDropAction) ``` [ 開始拖放操作，并返回一個值，指示請求的拖放操作何時完成。下拉的動作，用戶可以選擇在指定_supportedActions_。默認建議的行動會按以下順序允許的動作中進行選擇：移動，復制和鏈接。 **Note:**在Linux和Mac OS X上，拖放操作可能需要一些時間，但這個功能不會阻止事件循環。其他事件仍傳送到應用程序，同時執行操作。在Windows上， Qt的事件循環的操作過程中受阻時。此功能被引入Qt的4.3 。 ](qt.html#DropAction-enum) ``` Qt.DropAction QDrag.exec_ (self, Qt.DropActions?supportedActions?=?Qt.MoveAction) ``` [ 開始拖放操作，并返回一個值，指示請求的拖放操作何時完成。下拉的動作，用戶可以選擇在指定_supportedActions_。默認建議的行動會按以下順序允許的動作中進行選擇：移動，復制和鏈接。 **Note:**在Linux和Mac OS X上，拖放操作可能需要一些時間，但這個功能不會阻止事件循環。其他事件仍傳送到應用程序，同時執行操作。在Windows上， Qt的事件循環的操作過程中受阻時。此功能被引入Qt的4.3 。 ](qt.html#DropAction-enum) ``` Qt.DropAction QDrag.exec_ (self, Qt.DropActions?supportedActions, Qt.DropAction?defaultDropAction) ``` [ 開始拖放操作，并返回一個值，指示請求的拖放操作何時完成。下拉的動作，用戶可以選擇在指定_supportedActions_。該_defaultDropAction_決定當用戶執行一拖而不使用組合鍵的操作將被提出。 ](qt.html#DropAction-enum) [**Note:**在Linux和Mac OS X上，拖放操作可能需要一些時間，但這個功能不會阻止事件循環。其他事件仍傳送到應用程序，同時執行操作。在Windows上， Qt的事件循環的操作過程中受阻。但是，](qt.html#DropAction-enum)[QDrag.exec](qdrag.html#exec)（）在Windows上導致processEvents （）被頻繁調用，以保證GUI作出響應。如果有任何循環或操作被調用，而拖動操作是積極的，它會阻止拖動操作。此功能被引入Qt的4.3 。 ``` QPoint QDrag.hotSpot (self) ``` [ 返回到光標的左上角相對于熱點的位置。 ](qpoint.html) [**See also**](qpoint.html) [setHotSpot](qdrag.html#setHotSpot)（）。 ``` QMimeData QDrag.mimeData (self) ``` [ 返回由所述拖動對象所封裝的MIME數據。 ](qmimedata.html) [**See also**](qmimedata.html) [setMimeData](qdrag.html#setMimeData)（）。 ``` QPixmap QDrag.pixmap (self) ``` [ 返回用于表示在拖動的數據拖放操作的像素圖。 ](qpixmap.html) [**See also**](qpixmap.html) [setPixmap](qdrag.html#setPixmap)（）。 ``` QDrag.setDragCursor (self, QPixmap?cursor, Qt.DropAction?action) ``` 設置拖動_cursor_為_action_。這使您可以復蓋默認的本地游標。要恢復到使用本地光標_action_傳遞一個空[QPixmap](qpixmap.html)如_cursor_。該_action_只能是CopyAction ， MoveAction或LinkAction 。 DropAction的所有其他值將被忽略。 ``` QDrag.setHotSpot (self, QPoint?hotspot) ``` 設定相對于熱點的位置，以用于通過指定的點的像素圖的左上角_hotspot_。 **Note:**在X11上，像素圖可能無法跟上鼠標移動，如果熱點直接導致光標下要顯示的像素圖。 **See also** [hotSpot](qdrag.html#hotSpot)（）。 ``` QDrag.setMimeData (self, QMimeData?data) ``` 該_data_說法有它的所有權轉移給Qt的。設置要發送到給定的MIME數據_data_。該數據的所有權被轉移到[QDrag](qdrag.html)對象。 **See also** [mimeData](qdrag.html#mimeData)（）。 ``` QDrag.setPixmap (self, QPixmap) ``` Sets _pixmap_作為像素圖用來表示在一個拖動數據拖放操作。你可以拖動操作開始之前，只設置一個像素圖。 **See also** [pixmap](qdrag.html#pixmap)（）。 ``` QWidget QDrag.source (self) ``` [ 返回拖動對象的源。這是其中的拖放操作起源的部件。 ](qwidget.html) ``` Qt.DropAction QDrag.start (self, Qt.DropActions?supportedActions?=?Qt.CopyAction) ``` [](qt.html#DropAction-enum) ``` QWidget QDrag.target (self) ``` [ 返回拖放操作的目標。這是一個小部件，這是拖動物體跌。 * * * ## Qt Signal Documentation ``` void actionChanged (Qt::DropAction) ``` 這是該信號的默認超載。這個信號被發射時的_action_與拖變化有關。 ](qwidget.html) [**See also**](qwidget.html) [targetChanged](qdrag.html#targetChanged)（）。 ``` void targetChanged (QWidget *) ``` 這是該信號的默認超載。這個信號被發射時的拖放操作改變目標，以_newTarget_新的目標。 **See also** [target](qdrag.html#target)（）和[actionChanged](qdrag.html#actionChanged)（）。