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

#include <qgraphicssceneevent.h>

Inheritance diagram for QGraphicsSceneDragDropEvent:

Collaboration diagram for QGraphicsSceneDragDropEvent:

Public Member Functions
	QGraphicsSceneDragDropEvent (Type type=None)

	~QGraphicsSceneDragDropEvent ()

QPointF	pos () const

void	setPos (const QPointF &pos)

QPointF	scenePos () const

void	setScenePos (const QPointF &pos)

QPoint	screenPos () const

void	setScreenPos (const QPoint &pos)

Qt::MouseButtons	buttons () const

void	setButtons (Qt::MouseButtons buttons)

Qt::KeyboardModifiers	modifiers () const

void	setModifiers (Qt::KeyboardModifiers modifiers)

Qt::DropActions	possibleActions () const

void	setPossibleActions (Qt::DropActions actions)

Qt::DropAction	proposedAction () const

void	setProposedAction (Qt::DropAction action)

void	acceptProposedAction ()

Qt::DropAction	dropAction () const

void	setDropAction (Qt::DropAction action)

QWidget *	source () const

void	setSource (QWidget *source)

const QMimeData *	mimeData () const

void	setMimeData (const QMimeData *data)

Public Member Functions inherited from QGraphicsSceneEvent
	QGraphicsSceneEvent (Type type)

	~QGraphicsSceneEvent ()

QWidget *	widget () const

void	setWidget (QWidget *widget)

quint64	timestamp () const

void	setTimestamp (quint64 ts)

Public Member Functions inherited from QEvent
	QEvent (Type type)

virtual	~QEvent ()

Type	type () const

bool	spontaneous () const

virtual void	setAccepted (bool accepted)

bool	isAccepted () const

void	accept ()

void	ignore ()

bool	isInputEvent () const noexcept

bool	isPointerEvent () const noexcept

bool	isSinglePointEvent () const noexcept

virtual QEvent *	clone () const

Additional Inherited Members
Public Types inherited from QEvent
enum	Type { None = 0 , Timer = 1 , MouseButtonPress = 2 , MouseButtonRelease = 3 , MouseButtonDblClick = 4 , MouseMove = 5 , KeyPress = 6 , KeyRelease = 7 , FocusIn = 8 , FocusOut = 9 , FocusAboutToChange = 23 , Enter = 10 , Leave = 11 , Paint = 12 , Move = 13 , Resize = 14 , Create = 15 , Destroy = 16 , Show = 17 , Hide = 18 , Close = 19 , Quit = 20 , ParentChange = 21 , ParentAboutToChange = 131 , ThreadChange = 22 , WindowActivate = 24 , WindowDeactivate = 25 , ShowToParent = 26 , HideToParent = 27 , Wheel = 31 , WindowTitleChange = 33 , WindowIconChange = 34 , ApplicationWindowIconChange = 35 , ApplicationFontChange = 36 , ApplicationLayoutDirectionChange = 37 , ApplicationPaletteChange = 38 , PaletteChange = 39 , Clipboard = 40 , Speech = 42 , MetaCall = 43 , SockAct = 50 , WinEventAct = 132 , DeferredDelete = 52 , DragEnter = 60 , DragMove = 61 , DragLeave = 62 , Drop = 63 , DragResponse = 64 , ChildAdded = 68 , ChildPolished = 69 , ChildRemoved = 71 , ShowWindowRequest = 73 , PolishRequest = 74 , Polish = 75 , LayoutRequest = 76 , UpdateRequest = 77 , UpdateLater = 78 , EmbeddingControl = 79 , ActivateControl = 80 , DeactivateControl = 81 , ContextMenu = 82 , InputMethod = 83 , TabletMove = 87 , LocaleChange = 88 , LanguageChange = 89 , LayoutDirectionChange = 90 , Style = 91 , TabletPress = 92 , TabletRelease = 93 , OkRequest = 94 , HelpRequest = 95 , IconDrag = 96 , FontChange = 97 , EnabledChange = 98 , ActivationChange = 99 , StyleChange = 100 , IconTextChange = 101 , ModifiedChange = 102 , MouseTrackingChange = 109 , WindowBlocked = 103 , WindowUnblocked = 104 , WindowStateChange = 105 , ReadOnlyChange = 106 , ToolTip = 110 , WhatsThis = 111 , StatusTip = 112 , ActionChanged = 113 , ActionAdded = 114 , ActionRemoved = 115 , FileOpen = 116 , Shortcut = 117 , ShortcutOverride = 51 , WhatsThisClicked = 118 , ToolBarChange = 120 , ApplicationActivate = 121 , ApplicationActivated = ApplicationActivate , ApplicationDeactivate = 122 , ApplicationDeactivated = ApplicationDeactivate , QueryWhatsThis = 123 , EnterWhatsThisMode = 124 , LeaveWhatsThisMode = 125 , ZOrderChange = 126 , HoverEnter = 127 , HoverLeave = 128 , HoverMove = 129 , AcceptDropsChange = 152 , ZeroTimerEvent = 154 , GraphicsSceneMouseMove = 155 , GraphicsSceneMousePress = 156 , GraphicsSceneMouseRelease = 157 , GraphicsSceneMouseDoubleClick = 158 , GraphicsSceneContextMenu = 159 , GraphicsSceneHoverEnter = 160 , GraphicsSceneHoverMove = 161 , GraphicsSceneHoverLeave = 162 , GraphicsSceneHelp = 163 , GraphicsSceneDragEnter = 164 , GraphicsSceneDragMove = 165 , GraphicsSceneDragLeave = 166 , GraphicsSceneDrop = 167 , GraphicsSceneWheel = 168 , GraphicsSceneLeave = 220 , KeyboardLayoutChange = 169 , DynamicPropertyChange = 170 , TabletEnterProximity = 171 , TabletLeaveProximity = 172 , NonClientAreaMouseMove = 173 , NonClientAreaMouseButtonPress = 174 , NonClientAreaMouseButtonRelease = 175 , NonClientAreaMouseButtonDblClick = 176 , MacSizeChange = 177 , ContentsRectChange = 178 , MacGLWindowChange = 179 , FutureCallOut = 180 , GraphicsSceneResize = 181 , GraphicsSceneMove = 182 , CursorChange = 183 , ToolTipChange = 184 , NetworkReplyUpdated = 185 , GrabMouse = 186 , UngrabMouse = 187 , GrabKeyboard = 188 , UngrabKeyboard = 189 , StateMachineSignal = 192 , StateMachineWrapped = 193 , TouchBegin = 194 , TouchUpdate = 195 , TouchEnd = 196 , NativeGesture = 197 , RequestSoftwareInputPanel = 199 , CloseSoftwareInputPanel = 200 , WinIdChange = 203 , Gesture = 198 , GestureOverride = 202 , ScrollPrepare = 204 , Scroll = 205 , Expose = 206 , InputMethodQuery = 207 , OrientationChange = 208 , TouchCancel = 209 , ThemeChange = 210 , SockClose = 211 , PlatformPanel = 212 , StyleAnimationUpdate = 213 , ApplicationStateChange = 214 , WindowChangeInternal = 215 , ScreenChangeInternal = 216 , PlatformSurface = 217 , Pointer = 218 , TabletTrackingChange = 219 , User = 1000 , MaxUser = 65535 }

Static Public Member Functions inherited from QEvent
static int	registerEventType (int hint=-1) noexcept

Protected Member Functions inherited from QGraphicsSceneEvent
	QGraphicsSceneEvent (QGraphicsSceneEventPrivate &dd, Type type=None)

Protected Member Functions inherited from QEvent
	QEvent (Type type, InputEventTag)

	QEvent (Type type, PointerEventTag)

	QEvent (Type type, SinglePointEventTag)

Protected Attributes inherited from QGraphicsSceneEvent
QScopedPointer< QGraphicsSceneEventPrivate >	d_ptr

Protected Attributes inherited from QEvent
quint16	t

Detailed Description

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

Since: 4.2

\inmodule QtWidgets

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 \l{QGraphicsItem::}{setAcceptDrops()}.

Definition at line 258 of file qgraphicssceneevent.h.

Constructor & Destructor Documentation

◆ QGraphicsSceneDragDropEvent()

QGraphicsSceneDragDropEvent::QGraphicsSceneDragDropEvent ( Type type = None )

explicit

Definition at line 1407 of file qgraphicssceneevent.cpp.

◆ ~QGraphicsSceneDragDropEvent()

QGraphicsSceneDragDropEvent::~QGraphicsSceneDragDropEvent ( )

Destroys the object.

Definition at line 1415 of file qgraphicssceneevent.cpp.

Member Function Documentation

◆ acceptProposedAction()

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

Definition at line 1610 of file qgraphicssceneevent.cpp.

Here is the caller graph for this function:

◆ buttons()

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

Definition at line 1499 of file qgraphicssceneevent.cpp.

Here is the caller graph for this function:

◆ dropAction()

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

Definition at line 1624 of file qgraphicssceneevent.cpp.

Here is the caller graph for this function:

◆ mimeData()

const QMimeData * QGraphicsSceneDragDropEvent::mimeData ( ) const

This function returns the MIME data of the event.

Definition at line 1670 of file qgraphicssceneevent.cpp.

Here is the caller graph for this function:

◆ modifiers()

Qt::KeyboardModifiers QGraphicsSceneDragDropEvent::modifiers ( ) const

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

See also: Qt::KeyboardModifiers

Definition at line 1524 of file qgraphicssceneevent.cpp.

Here is the caller graph for this function:

◆ pos()

QPointF QGraphicsSceneDragDropEvent::pos ( ) const

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

See also: QGraphicsView, screenPos(), scenePos()

Definition at line 1425 of file qgraphicssceneevent.cpp.

Here is the caller graph for this function:

◆ possibleActions()

Qt::DropActions QGraphicsSceneDragDropEvent::possibleActions ( ) const

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

See also: Qt::DropActions

Definition at line 1551 of file qgraphicssceneevent.cpp.

◆ proposedAction()

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

Definition at line 1578 of file qgraphicssceneevent.cpp.

◆ scenePos()

QPointF QGraphicsSceneDragDropEvent::scenePos ( ) const

Returns the position of the mouse in scene coordinates.

See also: pos(), screenPos()

Definition at line 1451 of file qgraphicssceneevent.cpp.

Here is the caller graph for this function:

◆ screenPos()

QPoint QGraphicsSceneDragDropEvent::screenPos ( ) const

Returns the position of the mouse relative to the screen.

See also: pos(), scenePos()

Definition at line 1474 of file qgraphicssceneevent.cpp.

◆ setButtons()

void QGraphicsSceneDragDropEvent::setButtons ( Qt::MouseButtons buttons )

Definition at line 1512 of file qgraphicssceneevent.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setDropAction()

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 \l{QGraphicsSceneDragDropEvent::possibleActions()}{possible actions}. Call accept() in stead of acceptProposedAction() if you use this function.