CopperSpice API  1.7.2
QGraphicsSceneDragDropEvent Class Reference

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

Inheritance diagram for QGraphicsSceneDragDropEvent:
QGraphicsSceneEvent QEvent

Public Methods

 ~QGraphicsSceneDragDropEvent ()
 
void acceptProposedAction ()
 
Qt::MouseButtons buttons () const
 
Qt::DropAction dropAction () const
 
const QMimeDatamimeData () const
 
Qt::KeyboardModifiers modifiers () const
 
QPointF pos () const
 
Qt::DropActions possibleActions () const
 
Qt::DropAction proposedAction () const
 
QPointF scenePos () const
 
QPoint screenPos () const
 
void setDropAction (Qt::DropAction action)
 
QWidgetsource () const
 
- Public Methods inherited from QGraphicsSceneEvent
 ~QGraphicsSceneEvent ()
 
QWidgetwidget () const
 
- Public Methods inherited from QEvent
 QEvent (const QEvent &other)
 
 QEvent (Type type)
 
virtual ~QEvent ()
 
void accept ()
 
void ignore ()
 
bool isAccepted () const
 
QEvent & operator= (const QEvent &other)
 
void setAccepted (bool accepted)
 
bool spontaneous () const
 
Type type () const
 

Additional Inherited Members

- Public Types inherited from QEvent
enum  Type
 
- Static Public Methods inherited from QEvent
static int registerEventType (int hint=-1)
 

Detailed Description

The QGraphicsSceneDragDropEvent class provides events for drag and drop in the graphics view system. QGraphicsView inherits the drag and drop functionality provided by QWidget. When it receives a drag and drop event, it translates it to a QGraphicsSceneDragDropEvent.

This class stores events of type GraphicsSceneDragEnter, GraphicsSceneDragLeave, GraphicsSceneDragMove, or GraphicsSceneDrop. It 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().

See also
dropAction(), setDropAction(), proposedAction()

Constructor & Destructor Documentation

QGraphicsSceneDragDropEvent::~QGraphicsSceneDragDropEvent ( )

Destroys the object.

Method Documentation

void QGraphicsSceneDragDropEvent::acceptProposedAction ( )

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

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

See also
dropAction(), setDropAction(), proposedAction()
Qt::MouseButtons QGraphicsSceneDragDropEvent::buttons ( ) const

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

See also
Qt::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 by QDrag::exec().

See also
setDropAction(), acceptProposedAction()
const QMimeData * 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 also
Qt::KeyboardModifiers
QPointF QGraphicsSceneDragDropEvent::pos ( ) const

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

See also
QGraphicsView, screenPos(), scenePos()
Qt::DropActions QGraphicsSceneDragDropEvent::possibleActions ( ) const

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

See also
Qt::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 by possibleActions().

See also
Qt::DropAction, possibleActions()
QPointF QGraphicsSceneDragDropEvent::scenePos ( ) const

Returns the position of the mouse in scene coordinates.

See also
pos(), screenPos()
QPoint QGraphicsSceneDragDropEvent::screenPos ( ) const

Returns the position of the mouse relative to the screen.

See also
pos(), scenePos()
void QGraphicsSceneDragDropEvent::setDropAction ( Qt::DropAction  action)

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()
QWidget * QGraphicsSceneDragDropEvent::source ( ) const

This function returns the QGraphicsView that created the QGraphicsSceneDragDropEvent.