QGraphicsSceneDragDropEvent

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

Synopsis

Functions

• def acceptProposedAction ()

• def buttons ()

• def dropAction ()

• def mimeData ()

• def modifiers ()

• def pos ()

• def possibleActions ()

• def proposedAction ()

• def scenePos ()

• def screenPos ()

• def setButtons (buttons)

• def setDropAction (action)

• def setModifiers (modifiers)

• def setPos (pos)

• def setPossibleActions (actions)

• def setProposedAction (action)

• def setScenePos (pos)

• def setScreenPos (pos)

• def source ()

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() .

class PySide6.QtWidgets.QGraphicsSceneDragDropEvent([type=None])

Parameters

type – Type

Constructs a new QGraphicsSceneDragDropEvent of the specified type. The type can be either GraphicsSceneDragEnter , GraphicsSceneDragLeave , GraphicsSceneDragMove , or GraphicsSceneDrop .

PySide6.QtWidgets.QGraphicsSceneDragDropEvent.acceptProposedAction()

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().

See also

dropAction() setDropAction() proposedAction()

PySide6.QtWidgets.QGraphicsSceneDragDropEvent.buttons()

Return type

MouseButtons

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

See also

MouseButtons

PySide6.QtWidgets.QGraphicsSceneDragDropEvent.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 exec() .

See also

setDropAction() acceptProposedAction()

PySide6.QtWidgets.QGraphicsSceneDragDropEvent.mimeData()

Return type

PySide6.QtCore.QMimeData

This function returns the MIME data of the event.

PySide6.QtWidgets.QGraphicsSceneDragDropEvent.modifiers()

Return type

KeyboardModifiers

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

See also

KeyboardModifiers

PySide6.QtWidgets.QGraphicsSceneDragDropEvent.pos()

Return type

PySide6.QtCore.QPointF

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

See also

QGraphicsView screenPos() scenePos()

PySide6.QtWidgets.QGraphicsSceneDragDropEvent.possibleActions()

Return type

DropActions

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

See also

DropActions

PySide6.QtWidgets.QGraphicsSceneDragDropEvent.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().

See also

DropAction possibleActions()

PySide6.QtWidgets.QGraphicsSceneDragDropEvent.scenePos()

Return type

PySide6.QtCore.QPointF

Returns the position of the mouse in scene coordinates.

See also

pos() screenPos()

PySide6.QtWidgets.QGraphicsSceneDragDropEvent.screenPos()

Return type

PySide6.QtCore.QPoint

Returns the position of the mouse relative to the screen.

See also

pos() scenePos()

PySide6.QtWidgets.QGraphicsSceneDragDropEvent.setButtons(buttons)

Parameters

buttons – MouseButtons

Sets the mouse buttons that were pressed when the event was created to buttons.

See also

MouseButtons buttons()

PySide6.QtWidgets.QGraphicsSceneDragDropEvent.setDropAction(action)

Parameters

action – DropAction

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.

See also

dropAction() accept() possibleActions()

PySide6.QtWidgets.QGraphicsSceneDragDropEvent.setModifiers(modifiers)

Parameters

modifiers – KeyboardModifiers

Sets the keyboard modifiers that were pressed when the event was created to modifiers.

See also

KeyboardModifiers modifiers()

PySide6.QtWidgets.QGraphicsSceneDragDropEvent.setPos(pos)

Parameters

pos – PySide6.QtCore.QPointF

Sets the position of the mouse to pos; this should be relative to the widget that generated the event, which normally is a QGraphicsView .

See also

pos() setScenePos()setScreenPos()

PySide6.QtWidgets.QGraphicsSceneDragDropEvent.setPossibleActions(actions)

Parameters

actions – DropActions

Sets the possible drop actions that the drag can result in to actions.

See also

DropActions possibleActions()

PySide6.QtWidgets.QGraphicsSceneDragDropEvent.setProposedAction(action)

Parameters

action – DropAction

Sets the proposed action to action. The proposed action is a DropAction that is one of the possible actions as given by possibleActions().

See also

proposedAction() DropAction possibleActions()

PySide6.QtWidgets.QGraphicsSceneDragDropEvent.setScenePos(pos)

Parameters

pos – PySide6.QtCore.QPointF

Sets the scene position of the mouse to pos.

See also

scenePos() setScreenPos()setPos()

PySide6.QtWidgets.QGraphicsSceneDragDropEvent.setScreenPos(pos)

Parameters

pos – PySide6.QtCore.QPoint

Sets the mouse position relative to the screen to pos.

See also

screenPos() setScenePos()setPos()

PySide6.QtWidgets.QGraphicsSceneDragDropEvent.source()

Return type

PySide6.QtWidgets.QWidget

This function returns the QGraphicsView that created the QGraphicsSceneDragDropEvent .