class QDropEvent#

当拖放操作完成时，QDropEvent 类提供了一个事件。更多信息…

继承于： QDragMoveEvent，QDragEnterEvent

概述#

方法#

def __init__()
def __repr__()
def acceptProposedAction()
def buttons()
def dropAction()
def keyboardModifiers()
def mimeData()
def modifiers()
def mouseButtons()
def pos()
def posF()
定义 position()
定义 possibleActions()
定义 proposedAction()
定义 setDropAction()
定义 source()

注意

本文档可能包含自动从C++转换为Python的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您对翻译有疑问，也可以通过在https:/bugreports.qt.io/projects/PYSIDE上创建工单来告知我们。

详细描述#

当一个小部件接受拖放事件时，如果它接受了对它的最新QDragEnterEvent或QDragMoveEvent，则它将接收到此事件。

拖放事件包含一个proposedAction()，该作用可以被小部件接受或忽略。如果动作可以被小部件处理，应该调用acceptProposedAction()函数。由于建议的动作可以是Qt::DropAction值的组合，因此选择其中一个值作为默认动作或询问用户选择首选动作可能有用。

如果建议的拖放动作不合适，例如，因为您的自定义小部件不支持该动作，您可以通过调用setDropAction()并使用首选动作，用possible drop actions之一替换它。如果您设置了possibleActions()返回的值的按位或组合中不存在的值，将使用默认的复制动作。一旦设置了替换拖放动作，用acceptProposedAction()代替acceptProposedAction()以完成拖放操作。

mimeData()函数提供了一个QMimeData对象，其中包含小部件上拖放的数据。这包含了数据的MIME类型信息以及数据本身。

另请参阅

QDrag 拖放和删除

__init__(pos, actions, data, buttons, modifiers[, type=QEvent.Type.Drop])#

参数：

pos –

actions –

data –

buttons –

modifiers –

type –

构建一个与指定 type 的拖放事件，相应于在目标小部件坐标系中以 pos 指定点拖放。

表示可以执行哪些类型的拖放操作的是 actions，并会将拖动数据作为 MIME 编码数据存储在 data 中。

拖放时鼠标按钮和键盘修饰符的状态由 buttons 和 modifiers 指定。

__init__(arg__1)

__repr__()#

返回类型：: 对象

acceptProposedAction()#

将拖放动作设置为提议的动作。

另请参阅

buttons()#

返回类型：: 组合 MouseButton

返回被按下的鼠标按钮。

dropAction()#

返回类型：: DropAction

返回在目标上对数据进行操作的动作。如果已经通过调用 setDropAction() 显式选择一个拖放动作，这可能与 proposedAction() 中的动作不同。

另请参阅

setDropAction()

keyboardModifiers()#

返回类型：: 组合 KeyboardModifier

注意

此函数已过时。

使用 modifiers() 代替。

返回被按下的修改键。

mimeData()#

返回类型：: QMimeData

返回在控件上拖放的 KL 格式数据及其相关 MIME 类型信息。

modifiers()#

返回类型：: 组合 KeyboardModifier

返回被按下的修改键。

mouseButtons()#

返回类型：: 组合 MouseButton

注意

此函数已过时。

使用 buttons() 代替。

返回被按下的鼠标按钮。

pos()#

返回类型：: QPoint

注意

此函数已过时。

使用 position() .toPoint() 代替。

返回拖放操作的位置。

posF()#

返回类型：: QPointF

注意

此函数已过时。

使用 position() 代替。

返回拖放操作的位置。

position()#

返回类型：: QPointF

返回拖放操作的位置。

possibleActions()#

返回类型：: 组合 DropAction

返回可能拖放动作的或组合。

另请参阅

dropAction()

proposedAction()#

返回类型：: DropAction

返回建议的拖放动作。

另请参阅

dropAction()

setDropAction(action)#

参数：: action – DropAction

设置目标数据对应的操作。使用此函数可以覆盖proposed action，使用possible actions 之一。

如果你设置的操作不是可能操作之一，拖放操作将默认为复制操作。

一旦提供了替代的拖放操作，请调用 accept() 而不是 acceptProposedAction()。

另请参阅

dropAction()

source()#

返回类型：: QObject

如果拖动操作的源是本应用程序中的小工具，此函数返回该源；否则返回 None。操作源是用于实例化拖动的 QDrag 对象的第一参数。

这很有用，如果你的小工具需要在拖动自身时执行特殊行为。

另请参阅

QDrag()