# QDropEvent Class Reference ## [[QtGui](index.htm) module] 該QDropEvent類提供當拖放動作完成它發送的事件。[More...](#details) 繼承[QEvent](qevent.html)和[QMimeSource](qmimesource.html)。 通過繼承[QDragMoveEvent](qdragmoveevent.html)。 ### Methods * `__init__ (self, QPoint?pos, Qt.DropActions?actions, QMimeData?data, Qt.MouseButtons?buttons, Qt.KeyboardModifiers?modifiers, QEvent.Type?type?=?QEvent.Drop)` * `__init__ (self, QDropEvent)` * `acceptProposedAction (self)` * `Qt.DropAction dropAction (self)` * `QByteArray encodedData (self, str)` * `str format (self, int?n?=?0)` * `Qt.KeyboardModifiers keyboardModifiers (self)` * `QMimeData mimeData (self)` * `Qt.MouseButtons mouseButtons (self)` * `QPoint pos (self)` * `Qt.DropActions possibleActions (self)` * `Qt.DropAction proposedAction (self)` * `bool provides (self, str)` * `setDropAction (self, Qt.DropAction?action)` * `QWidget source (self)` * * * ## Detailed Description 該QDropEvent類提供當拖放動作完成它發送的事件。 當一個widget[accepts drop events](qwidget.html#acceptDrops-prop)，它會收到此事件，如果它已經接受了最新的[QDragEnterEvent](qdragenterevent.html) or [QDragMoveEvent](qdragmoveevent.html)發送給它。 drop事件中包含一個建議的行動，可從[proposedAction](qdropevent.html#proposedAction)（ ） ，窗口小部件可以選擇接受或忽略。如果操作可以通過小部件來處理，你應該調用[acceptProposedAction](qdropevent.html#acceptProposedAction)（）函數。由于建議的動作可以組合[Qt.DropAction](qt.html#DropAction-enum)值，它可能是有用要么選擇這些值作為默認行為之一的，或要求用戶選擇自己喜歡的動作。 如果擬議的拖放操作是不適合的，也許是因為你的自定義窗口小部件不支持該操作，您可以使用任何的更換[possible drop actions](qdropevent.html#possibleActions)通過調用[setDropAction](qdropevent.html#setDropAction)（ ）與您的首選動作。如果設置的值不存在由返回值的按位或組合[possibleActions](qdropevent.html#possibleActions)（ ） ，默認的復制操作將被使用。一旦更換拖放操作已經設定，調用accept （ ）代替[acceptProposedAction](qdropevent.html#acceptProposedAction)（ ）來完成拖放操作。 該[mimeData](qdropevent.html#mimeData)（）函數提供的數據在一個滴在插件[QMimeData](qmimedata.html)對象。這包含了MIME類型，除了數據本身的數據的信息。 * * * ## Method Documentation ``` QDropEvent.__init__ (self, QPoint?pos, Qt.DropActions?actions, QMimeData?data, Qt.MouseButtons?buttons, Qt.KeyboardModifiers?modifiers, QEvent.Type?type?=?QEvent.Drop) ``` 構造有一定的下降事件_type_對應于一滴在由所指定的點_pos_在目標窗口部件的坐標系。 該_actions_指示哪些類型的拖放操作可以被執行，并且拖動數據被存儲為MIME編碼的數據_data_。 鼠標按鈕和鍵盤功能鍵在下拉時的狀態由指定_buttons_和_modifiers_。 ``` QDropEvent.__init__ (self, QDropEvent) ``` ``` QDropEvent.acceptProposedAction (self) ``` 設置下拉動作要建議的行動。 **See also** [setDropAction](qdropevent.html#setDropAction)（ ）[proposedAction](qdropevent.html#proposedAction)（）和[accept](qevent.html#accept)（ ） 。 ``` Qt.DropAction QDropEvent.dropAction (self) ``` [](qt.html#DropAction-enum) [返回到由目標上的數據執行的操作。這可能與所提供的不同的行動](qt.html#DropAction-enum)[proposedAction](qdropevent.html#proposedAction)（）如果你已經調用[setDropAction](qdropevent.html#setDropAction)（ ）顯式地選擇一個拖放操作。 **See also** [setDropAction](qdropevent.html#setDropAction)（ ） 。 ``` QByteArray QDropEvent.encodedData (self, str) ``` [ ``` str QDropEvent.format (self, int?n?=?0) ``` ](qbytearray.html) ``` Qt.KeyboardModifiers QDropEvent.keyboardModifiers (self) ``` [ 返回按下的修改鍵。 ](index.htm) ``` QMimeData QDropEvent.mimeData (self) ``` [ 返回滴加在部件上和其相關聯的MIME類型的信息的數據。 ](qmimedata.html) ``` Qt.MouseButtons QDropEvent.mouseButtons (self) ``` [ 返回按下的鼠標鍵.. ](index.htm) ``` QPoint QDropEvent.pos (self) ``` [ 返回在下拉作出的位置。 ](qpoint.html) ``` Qt.DropActions QDropEvent.possibleActions (self) ``` [ 返回的可能下降的動作或組合。 ](index.htm) [**See also**](index.htm) [dropAction](qdropevent.html#dropAction)（ ） 。 ``` Qt.DropAction QDropEvent.proposedAction (self) ``` [ 返回建議的拖放操作。 ](qt.html#DropAction-enum) [**See also**](qt.html#DropAction-enum) [dropAction](qdropevent.html#dropAction)（ ） 。 ``` bool QDropEvent.provides (self, str) ``` ``` QDropEvent.setDropAction (self, Qt.DropAction?action) ``` 設置_action_可以通過在目標上的數據進行的。用它來復蓋[proposed action](qdropevent.html#proposedAction)與所述一個[possible actions](qdropevent.html#possibleActions)。 如果設置了下拉動作，是不是可能的動作之一，拖放操作將默認的復制操作。 一旦你提供一個替代拖放操作，調用accept （ ）代替[acceptProposedAction](qdropevent.html#acceptProposedAction)（ ） 。 **See also** [dropAction](qdropevent.html#dropAction)（ ） 。 ``` QWidget QDropEvent.source (self) ``` [](qwidget.html) [如果拖動操作的來源是在這個應用程序中的小工具，這個函數返回源，否則返回0 。操作的源是所述第一參數的](qwidget.html)[QDrag](qdrag.html)使用對象實例化的阻力。 如果拖動到自己，當你的widget需要特殊的行為，這是很有用的。 **See also** [QDrag.QDrag](qdrag.html#QDrag)（ ） 。