QDropEvent 类提供被发送的事件当拖放操作完成时。 更多...
| 头： | #include <QDropEvent> |
| CMake: |
find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| 继承： | QEvent |
| 继承者： | QDragMoveEvent |
| QDropEvent (const QPointF & pos , Qt::DropActions actions , const QMimeData * data , Qt::MouseButtons buttons , Qt::KeyboardModifiers modifiers , QEvent::Type type = Drop) | |
| void | acceptProposedAction () |
| Qt::MouseButtons | buttons () const |
| Qt::DropAction | dropAction () const |
| const QMimeData * | mimeData () const |
| Qt::KeyboardModifiers | modifiers () const |
| QPointF | position () const |
| Qt::DropActions | possibleActions () const |
| Qt::DropAction | proposedAction () const |
| void | setDropAction (Qt::DropAction action ) |
| QObject * | source () const |
当 Widget 接受掉落事件 ，将接收此事件若它有接受最近 QDragEnterEvent or QDragMoveEvent 发送给它的。
掉落事件包含提议动作，可获取自 proposedAction ()，供 Widget 接受或忽略。若可以通过 Widget 处理动作，则应调用 acceptProposedAction () 函数。由于提议动作可以组合 Qt::DropAction 值，选择这些值之一作为默认动作或询问用户以选择其首选动作，可能是有用的。
若提议掉落动作不适合，或许因为自定义 Widget 不支持该动作，可以将其替换为任何 可能掉落动作 通过调用 setDropAction () 采用首选动作。若设置值不存在在按位 OR 组合的值中，返回通过 possibleActions ()，将使用默认拷贝动作。一旦设置置换掉落动作，就可调用 accept () 而不是 acceptProposedAction () 以完成掉落操作。
The mimeData () 函数提供 Widget 掉落数据，在 QMimeData 对象。这包含数据 MIME 类型的有关信息，除数据本身外。
另请参阅 QMimeData , QDrag ，和 拖放 .
Constructs a drop event of a certain type corresponding to a drop at the point specified by pos in the destination widget's coordinate system.
The actions indicate which types of drag and drop operation can be performed, and the drag data is stored as MIME-encoded data in data .
The states of the mouse buttons and keyboard modifiers at the time of the drop are specified by buttons and modifiers .
把拖拽运转设为提议动作。
另请参阅 setDropAction (), proposedAction ()，和 accept ().
[since 6.0]
Qt::MouseButtons
QDropEvent::
buttons
() const
返回被按下的鼠标按钮。
该函数在 Qt 6.0 引入。
Returns the action to be performed on the data by the target. This may be different from the action supplied in proposedAction () if you have called setDropAction () to explicitly choose a drop action.
另请参阅 setDropAction ().
返回掉落在 Widget 上的数据及其关联 MIME 类型信息。
[since 6.0]
Qt::KeyboardModifiers
QDropEvent::
modifiers
() const
返回被按下的修饰符键。
该函数在 Qt 6.0 引入。
[since 6.0]
QPointF
QDropEvent::
position
() const
返回掉落点位置。
该函数在 Qt 6.0 引入。
返回可能掉落动作的 OR 组合。
另请参阅 dropAction ().
返回提议掉落动作。
另请参阅 dropAction ().
设置 action 以由目标履行数据。使用这以覆盖 提议动作 采用某一 可能的动作 .
若设置的掉落动作不是可能的动作之一，拖放操作将默认为拷贝操作。
一旦提供置换掉落动作，就可调用 accept () 而不是 acceptProposedAction ().
另请参阅 dropAction ().
If the source of the drag operation is a widget in this application, this function returns that source; otherwise it returns
nullptr
. The source of the operation is the first parameter to the
QDrag
object used instantiate the drag.
This is useful if your widget needs special behavior when dragging to itself.
另请参阅 QDrag::QDrag ().