Contents

• Public Functions
• Detailed Description

Detailed Description

TheQGraphicsSceneDragDropEvent class provides events for drag and drop in the graphics view framework.

QGraphicsView inherits the drag and drop functionality provided byQWidget. When it receives a drag and drop event, it translates it to aQGraphicsSceneDragDropEvent.

QGraphicsSceneDragDropEvent stores events of typeGraphicsSceneDragEnter,GraphicsSceneDragLeave,GraphicsSceneDragMove, orGraphicsSceneDrop.

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

The scene sends the event to the firstQGraphicsItem under the mouse cursor that accepts drops; a graphics item is set to accept drops withsetAcceptDrops().

Member Function Documentation

QGraphicsSceneDragDropEvent::~QGraphicsSceneDragDropEvent()

Destroys the object.

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

See alsodropAction(),setDropAction(), andproposedAction().

Qt::MouseButtons QGraphicsSceneDragDropEvent::buttons() const

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

See alsoQt::MouseButtons.

Qt::DropAction QGraphicsSceneDragDropEvent::dropAction() const

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

See alsosetDropAction() andacceptProposedAction().

constQMimeData * QGraphicsSceneDragDropEvent::mimeData() const

This function returns the MIME data of the event.

Qt::KeyboardModifiers QGraphicsSceneDragDropEvent::modifiers() const

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

See alsoQt::KeyboardModifiers.

QPointF QGraphicsSceneDragDropEvent::pos() const

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

See alsoQGraphicsView,screenPos(), andscenePos().

Qt::DropActions QGraphicsSceneDragDropEvent::possibleActions() const

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

See alsoQt::DropActions.

Qt::DropAction QGraphicsSceneDragDropEvent::proposedAction() const

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

See alsoQt::DropAction andpossibleActions().

QPointF QGraphicsSceneDragDropEvent::scenePos() const

Returns the position of the mouse in scene coordinates.

See alsopos() andscreenPos().

QPoint QGraphicsSceneDragDropEvent::screenPos() const

Returns the position of the mouse relative to the screen.

See alsopos() andscenePos().

void QGraphicsSceneDragDropEvent::setDropAction(Qt::DropAction action)

This function lets the receiver of the drop set the drop action that was performed toaction, which should be one of thepossible actions. Callaccept() in stead ofacceptProposedAction() if you use this function.

See alsodropAction(),accept(), andpossibleActions().

QWidget * QGraphicsSceneDragDropEvent::source() const

This function returns theQGraphicsView that created theQGraphicsSceneDragDropEvent.