PySide6.QtGui.QDropEvent¶

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()
def position()
def possibleActions()
def proposedAction()
def setDropAction()
def source()

注意

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

详细描述¶

当一个小部件接受拖放事件时，如果它已经接受了最近发送给它的QDragEnterEvent或QDragMoveEvent，它将接收到此事件。

拖放事件包含一个建议的操作，可从proposedAction()获取，供小部件接受或忽略。如果小部件可以处理该操作，您应该调用acceptProposedAction()函数。由于建议的操作可能是Qt::DropAction值的组合，因此选择其中一个值作为默认操作或要求用户选择他们偏好的操作可能是有用的。

如果建议的拖放操作不合适，可能是因为您的自定义小部件不支持该操作，您可以通过调用setDropAction()并指定您首选的操作来替换为任何可能的拖放操作。如果您设置的值不在possibleActions()返回的值的按位或组合中，将使用默认的复制操作。一旦设置了替换的拖放操作，请调用accept()而不是acceptProposedAction()来完成拖放操作。

mimeData() 函数提供了在小部件上拖放的数据，这些数据包含在一个 QMimeData 对象中。除了数据本身外，还包含有关数据 MIME 类型的信息。

另请参阅

QDrag 拖放

__init__(arg__1)¶

Parameters:: arg__1 – QDropEvent

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

Parameters:

pos – QPointF
actions – DropAction 的组合
data – QMimeData
buttons – MouseButton 的组合
modifiers – KeyboardModifier 的组合
type – 类型

构造一个特定type的拖放事件，该事件对应于目标小部件坐标系中由pos指定的点的拖放。

actions 表示可以执行哪些类型的拖放操作，而拖放数据以MIME编码的形式存储在 data 中。

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

__repr__()¶

Return type:: 字符串

acceptProposedAction()¶

将拖放操作设置为建议的操作。

另请参阅

setDropAction() proposedAction() accept()

buttons()¶

Return type:: MouseButton 的组合

返回被按下的鼠标按钮。

dropAction()¶

Return type:: DropAction

返回目标对数据执行的操作。如果您调用了setDropAction()来明确选择一个放置操作，这可能与proposedAction()中提供的操作不同。

另请参阅

setDropAction()

keyboardModifiers()¶

Return type:: KeyboardModifier的组合

注意

此函数已弃用。

请使用modifiers()代替。

返回按下的修饰键。

mimeData()¶

Return type:: QMimeData

返回在小部件上拖放的数据及其相关的MIME类型信息。

modifiers()¶

Return type:: KeyboardModifier的组合

返回按下的修饰键。

mouseButtons()¶

Return type:: MouseButton 的组合

注意

此函数已弃用。

请使用buttons()代替。

返回被按下的鼠标按钮。

pos()¶

Return type:: QPoint

注意

此函数已弃用。

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

返回放置的位置。

posF()¶

Return type:: QPointF

注意

此函数已弃用。

使用 position() 代替。

返回放置的位置。

position()¶

Return type:: QPointF

返回放置的位置。

possibleActions()¶

Return type:: DropAction的组合

返回可能的拖放操作的OR组合。

另请参阅

dropAction()

proposedAction()¶

Return type:: DropAction

返回建议的拖放操作。

另请参阅

dropAction()

setDropAction(action)¶

Parameters:: 动作 – DropAction

设置目标对数据执行的action。使用此功能可以用possible actions之一覆盖proposed action。

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

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

另请参阅

dropAction()

source()¶

Return type:: QObject

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

如果您的窗口小部件在拖动到自身时需要特殊行为，这将非常有用。

另请参阅

QDrag()