Auf dieser Seite

QGraphicsSceneDragDropEvent Class

Die Klasse „QGraphicsSceneDragDropEvent“ stellt Ereignisse für Drag-and-Drop im Grafikansichts-Framework bereit. Mehr...

Header: #include <QGraphicsSceneDragDropEvent>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Erbt von: QGraphicsSceneEvent

Öffentliche Funktionen

virtual ~QGraphicsSceneDragDropEvent()
void acceptProposedAction()
Qt::MouseButtons buttons() const
Qt::DropAction dropAction() const
const QMimeData *mimeData() 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)
QWidget *source() const

Ausführliche Beschreibung

QGraphicsView Erbt die Drag-and-Drop-Funktionalität von ` QWidget`. Wenn es ein Drag-and-Drop-Ereignis empfängt, wandelt es dieses in ein `QGraphicsSceneDragDropEvent` um.

`QGraphicsSceneDragDropEvent` speichert Ereignisse vom Typ `GraphicsSceneDragEnter`, `GraphicsSceneDragLeave`, `GraphicsSceneDragMove` oder `GraphicsSceneDrop`.

`QGraphicsSceneDragDropEvent` enthält die Position des Mauszeigers sowohl in Element- als auch in Szenen- und Bildschirmkoordinaten; diese kann mit ` pos()`, ` scenePos()` und ` screenPos()` abgerufen werden.

Die Szene sendet das Ereignis an das erste „ QGraphicsItem “ unter dem Mauszeiger, das das Ablegen akzeptiert; ein Grafikobjekt wird mit „ setAcceptDrops()“ so eingestellt, dass es das Ablegen akzeptiert.

Dokumentation der Member-Funktionen

[virtual noexcept] QGraphicsSceneDragDropEvent::~QGraphicsSceneDragDropEvent()

Löscht das Objekt.

void QGraphicsSceneDragDropEvent::acceptProposedAction()

Setzt die vorgeschlagene Aktion auf „akzeptiert“, d. h., die Drop-Aktion wird auf die vorgeschlagene Aktion gesetzt. Dies entspricht:

setDropAction(proposedAction());

Bei Verwendung dieser Funktion sollte man „ accept() “ nicht aufrufen.

Siehe auch „ dropAction()“, „ setDropAction()“ und „ proposedAction()“.

Qt::MouseButtons QGraphicsSceneDragDropEvent::buttons() const

Gibt einen Wert vom Typ „ Qt::MouseButtons “ zurück, der angibt, welche Maustasten bei der Auslösung dieses Mausereignisses gedrückt wurden.

Siehe auch Qt::MouseButtons.

Qt::DropAction QGraphicsSceneDragDropEvent::dropAction() const

Gibt die Aktion zurück, die bei diesem Drag-and-Drop-Vorgang ausgeführt wurde. Diese sollte vom Empfänger des Drop-Vorgangs festgelegt werden und wird von der Funktion „ QDrag::exec()“ zurückgegeben.

Siehe auch setDropAction() und acceptProposedAction().

const QMimeData *QGraphicsSceneDragDropEvent::mimeData() const

Diese Funktion gibt die MIME-Daten des Ereignisses zurück.

Qt::KeyboardModifiers QGraphicsSceneDragDropEvent::modifiers() const

Gibt die Tastaturmodifikatoren zurück, die zum Zeitpunkt der Auslösung des Drag-and-Drop-Ereignisses gedrückt waren.

Siehe auch „ Qt::KeyboardModifiers “.

QPointF QGraphicsSceneDragDropEvent::pos() const

Gibt die Mausposition des Ereignisses relativ zu der Ansicht zurück, die das Ereignis gesendet hat.

Siehe auch „ QGraphicsView“ , „ screenPos()“ und „ scenePos()“.

Qt::DropActions QGraphicsSceneDragDropEvent::possibleActions() const

Gibt die möglichen Ablageaktionen zurück, zu denen das Ziehen und Ablegen führen kann.

Siehe auch Qt::DropActions.

Qt::DropAction QGraphicsSceneDragDropEvent::proposedAction() const

Gibt die vorgeschlagene, d. h. bevorzugte Drop-Aktion zurück. Die Aktion muss eine der möglichen Aktionen sein, wie sie unter possibleActions() definiert sind.

Siehe auch Qt::DropAction und possibleActions().

QPointF QGraphicsSceneDragDropEvent::scenePos() const

Gibt die Position der Maus in Szenenkoordinaten zurück.

Siehe auch pos() und screenPos().

QPoint QGraphicsSceneDragDropEvent::screenPos() const

Gibt die Position der Maus relativ zum Bildschirm zurück.

Siehe auch pos() und scenePos().

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

Mit dieser Funktion kann der Empfänger des Drops die durchgeführte Drop-Aktion auf „ action “ setzen, wobei es sich um einen der Werte aus „ possible actions “ handeln muss. Rufen Sie in diesem Fall „ accept() “ anstelle von „ acceptProposedAction() “ auf.

Siehe auch dropAction(), accept() und possibleActions().

QWidget *QGraphicsSceneDragDropEvent::source() const

Diese Funktion gibt den „ QGraphicsView “ zurück, der den „ QGraphicsSceneDragDropEvent “ erstellt hat.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.