QGraphicsSceneDragDropEvent Class
Die Klasse QGraphicsSceneDragDropEvent stellt Ereignisse für das Ziehen und Ablegen von Objekten in der Grafikansicht bereit. Mehr...
| Kopfzeile: | #include <QGraphicsSceneDragDropEvent> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Vererbt: | 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 |
Detaillierte Beschreibung
QGraphicsView erbt die Drag&Drop-Funktionalität, die von QWidget bereitgestellt wird. Wenn sie ein Drag&Drop-Ereignis empfängt, wandelt sie es in ein QGraphicsSceneDragDropEvent um.
QGraphicsSceneDragDropEvent speichert Ereignisse vom Typ GraphicsSceneDragEnter, GraphicsSceneDragLeave, GraphicsSceneDragMove oder GraphicsSceneDrop.
QGraphicsSceneDragDropEvent enthält die Position des Mauszeigers in Element-, 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 Drops akzeptiert; ein Grafikelement wird mit setAcceptDrops() so eingestellt, dass es Drops akzeptiert.
Dokumentation der Mitgliedsfunktionen
[virtual noexcept] QGraphicsSceneDragDropEvent::~QGraphicsSceneDragDropEvent()
Zerstört das Objekt.
void QGraphicsSceneDragDropEvent::acceptProposedAction()
Legt die vorgeschlagene Aktion als akzeptiert fest, d.h. die Abbruchaktion wird auf die vorgeschlagene Aktion gesetzt. Dies ist gleichbedeutend mit:
setDropAction(proposedAction());
Wenn man diese Funktion verwendet, sollte man nicht accept() aufrufen.
Siehe auch dropAction(), setDropAction(), und proposedAction().
Qt::MouseButtons QGraphicsSceneDragDropEvent::buttons() const
Gibt einen Wert Qt::MouseButtons zurück, der angibt, welche Tasten mit der Maus gedrückt wurden, als dieses Mausereignis erzeugt wurde.
Siehe auch Qt::MouseButtons.
Qt::DropAction QGraphicsSceneDragDropEvent::dropAction() const
Gibt die Aktion zurück, die bei diesem Drag&Drop durchgeführt wurde. Diese sollte vom Empfänger des Drop gesetzt werden und wird von 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 gedrückt wurden, als das Drag&Drop-Ereignis erstellt wurde.
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 Ablegeaktionen zurück, die das Ziehen und Ablegen zur Folge haben kann.
Siehe auch Qt::DropActions.
Qt::DropAction QGraphicsSceneDragDropEvent::proposedAction() const
Gibt die vorgeschlagene, d. h. die bevorzugte Abwurfaktion zurück. Die Aktion muss eine der möglichen Aktionen sein, die durch possibleActions() definiert sind.
Siehe auch Qt::DropAction und possibleActions().
QPointF QGraphicsSceneDragDropEvent::scenePos() const
Gibt die Position der Maus in Szenekoordinaten 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 Drop-Aktion, die durchgeführt wurde, auf action setzen, was eine der possible actions sein sollte. Rufen Sie accept() anstelle von acceptProposedAction() auf, wenn Sie diese Funktion verwenden.
Siehe auch dropAction(), accept(), und possibleActions().
QWidget *QGraphicsSceneDragDropEvent::source() const
Diese Funktion gibt die QGraphicsView zurück, die die QGraphicsSceneDragDropEvent erstellt hat.
© 2025 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.
