class QGraphicsSceneDragDropEvent

The QGraphicsSceneDragDropEvent class provides events for drag and drop in the graphics view framework. More

Inheritance diagram of PySide6.QtWidgets.QGraphicsSceneDragDropEvent

Synopsis

Methods

Note

This documentation may contain snippets that were automatically translated from C++ to Python. We always welcome contributions to the snippet translation. If you see an issue with the translation, you can also let us know by creating a ticket on https:/bugreports.qt.io/projects/PYSIDE

Detailed Description

QGraphicsView inherits the drag and drop functionality provided by QWidget . When it receives a drag and drop event, it translates it to a QGraphicsSceneDragDropEvent .

QGraphicsSceneDragDropEvent stores events of type GraphicsSceneDragEnter, GraphicsSceneDragLeave, GraphicsSceneDragMove, or GraphicsSceneDrop.

QGraphicsSceneDragDropEvent contains the position of the mouse cursor in both item, scene, and screen coordinates; this can be retrieved with pos() , scenePos() , and screenPos() .

The scene sends the event to the first QGraphicsItem under the mouse cursor that accepts drops; a graphics item is set to accept drops with setAcceptDrops() .

__init__([type=QEvent.Type.None])
Parameters:

typeType

acceptProposedAction()

Warning

This section contains snippets that were automatically translated from C++ to Python and may contain errors.

Sets the proposed action as accepted, i.e, the drop action is set to the proposed action. This is equal to:

setDropAction(proposedAction())

When using this function, one should not call accept().

buttons()
Return type:

Combination of MouseButton

Returns a Qt::MouseButtons value indicating which buttons were pressed on the mouse when this mouse event was generated.

See also

MouseButtons

dropAction()
Return type:

DropAction

Returns the action that was performed in this drag and drop. This should be set by the receiver of the drop and is returned by QDrag::exec().

mimeData()
Return type:

QMimeData

This function returns the MIME data of the event.

modifiers()
Return type:

Combination of KeyboardModifier

Returns the keyboard modifiers that were pressed when the drag and drop event was created.

See also

KeyboardModifiers

pos()
Return type:

QPointF

Returns the mouse position of the event relative to the view that sent the event.

possibleActions()
Return type:

Combination of DropAction

Returns the possible drop actions that the drag and drop can result in.

See also

DropActions

proposedAction()
Return type:

DropAction

Returns the drop action that is proposed, i.e., preferred. The action must be one of the possible actions as defined by possibleActions().

scenePos()
Return type:

QPointF

Returns the position of the mouse in scene coordinates.

See also

pos() screenPos()

screenPos()
Return type:

QPoint

Returns the position of the mouse relative to the screen.

See also

pos() scenePos()

setButtons(buttons)
Parameters:

buttons – Combination of MouseButton

setDropAction(action)
Parameters:

actionDropAction

This function lets the receiver of the drop set the drop action that was performed to action, which should be one of the possible actions . Call accept() in stead of acceptProposedAction() if you use this function.

setModifiers(modifiers)
Parameters:

modifiers – Combination of KeyboardModifier

setPos(pos)
Parameters:

posQPointF

setPossibleActions(actions)
Parameters:

actions – Combination of DropAction

setProposedAction(action)
Parameters:

actionDropAction

setScenePos(pos)
Parameters:

posQPointF

setScreenPos(pos)
Parameters:

posQPoint

source()
Return type:

QWidget

This function returns the QGraphicsView that created the QGraphicsSceneDragDropEvent .