QDropEvent Class
Die Klasse QDropEvent stellt ein Ereignis bereit, das gesendet wird, wenn eine Drag&Drop-Aktion abgeschlossen ist. Mehr...
| Kopfzeile: | #include <QDropEvent> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui)target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| Vererbt: | QEvent |
| Vererbt von: |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- Veraltete Mitglieder
- QDropEvent ist Teil von Event Classes.
Öffentliche Funktionen
| QDropEvent(const QPointF &pos, Qt::DropActions actions, const QMimeData *data, Qt::MouseButtons buttons, Qt::KeyboardModifiers modifiers, QEvent::Type type = Drop) | |
| void | acceptProposedAction() |
(since 6.0) Qt::MouseButtons | buttons() const |
| Qt::DropAction | dropAction() const |
| const QMimeData * | mimeData() const |
(since 6.0) Qt::KeyboardModifiers | modifiers() const |
(since 6.0) QPointF | position() const |
| Qt::DropActions | possibleActions() const |
| Qt::DropAction | proposedAction() const |
| void | setDropAction(Qt::DropAction action) |
| QObject * | source() const |
Detaillierte Beschreibung
Wenn ein Widget accepts drop events, erhält es dieses Ereignis, wenn es die zuletzt an es gesendete QDragEnterEvent oder QDragMoveEvent akzeptiert hat.
Das Drop-Ereignis enthält eine vorgeschlagene Aktion, die von proposedAction() verfügbar ist und die das Widget entweder annehmen oder ignorieren kann. Wenn die Aktion vom Widget verarbeitet werden kann, sollten Sie die Funktion acceptProposedAction() aufrufen. Da die vorgeschlagene Aktion eine Kombination aus Qt::DropAction Werten sein kann, kann es nützlich sein, entweder einen dieser Werte als Standardaktion auszuwählen oder den Benutzer aufzufordern, seine bevorzugte Aktion auszuwählen.
Wenn die vorgeschlagene Drop-Aktion nicht geeignet ist, z. B. weil Ihr benutzerdefiniertes Widget diese Aktion nicht unterstützt, können Sie sie durch eine der possible drop actions ersetzen, indem Sie setDropAction() mit Ihrer bevorzugten Aktion aufrufen. Wenn Sie einen Wert setzen, der nicht in der bitweisen ODER-Kombination der von possibleActions() zurückgegebenen Werte enthalten ist, wird die Standard-Kopieraktion verwendet. Sobald Sie eine Ersatzaktion für das Ablegen festgelegt haben, rufen Sie accept() anstelle von acceptProposedAction() auf, um den Ablegevorgang abzuschließen.
Die Funktion mimeData() liefert die auf dem Widget abgelegten Daten in einem QMimeData Objekt. Dieses enthält neben den Daten selbst auch Informationen über den MIME-Typ der Daten.
Siehe auch QMimeData, QDrag, und Drag and Drop.
Dokumentation der Mitgliedsfunktionen
QDropEvent::QDropEvent(const QPointF &pos, Qt::DropActions actions, const QMimeData *data, Qt::MouseButtons buttons, Qt::KeyboardModifiers modifiers, QEvent::Type type = Drop)
Konstruiert ein Drop-Ereignis eines bestimmten type, das einem Drop an dem durch pos angegebenen Punkt im Koordinatensystem des Ziel-Widgets entspricht.
Die actions geben an, welche Arten von Drag- und Drop-Operationen durchgeführt werden können, und die Drag-Daten werden als MIME-kodierte Daten in data gespeichert.
Die Zustände der Maustasten und Tastaturmodifikatoren zum Zeitpunkt des Ablegens werden durch buttons und modifiers angegeben.
void QDropEvent::acceptProposedAction()
Setzt die Drop-Aktion auf die vorgeschlagene Aktion.
Siehe auch setDropAction(), proposedAction(), und accept().
[since 6.0] Qt::MouseButtons QDropEvent::buttons() const
Gibt die gedrückten Maustasten zurück.
Diese Funktion wurde in Qt 6.0 eingeführt.
Qt::DropAction QDropEvent::dropAction() const
Gibt die Aktion zurück, die das Ziel mit den Daten durchführen soll. Diese kann sich von der in proposedAction() angegebenen Aktion unterscheiden, wenn Sie setDropAction() aufgerufen haben, um explizit eine Drop-Aktion auszuwählen.
Siehe auch setDropAction().
const QMimeData *QDropEvent::mimeData() const
Liefert die Daten, die auf dem Widget abgelegt wurden, und die zugehörigen MIME-Typ-Informationen.
[since 6.0] Qt::KeyboardModifiers QDropEvent::modifiers() const
Gibt die gedrückten Modifier-Tasten zurück.
Diese Funktion wurde in Qt 6.0 eingeführt.
[since 6.0] QPointF QDropEvent::position() const
Gibt die Position zurück, an der der Abwurf stattgefunden hat.
Diese Funktion wurde in Qt 6.0 eingeführt.
Qt::DropActions QDropEvent::possibleActions() const
Liefert eine ODER-Kombination möglicher Drop-Aktionen.
Siehe auch dropAction().
Qt::DropAction QDropEvent::proposedAction() const
Gibt die vorgeschlagene Drop-Aktion zurück.
Siehe auch dropAction().
void QDropEvent::setDropAction(Qt::DropAction action)
Legt die action fest, die vom Ziel auf die Daten angewendet werden soll. Verwenden Sie dies, um die proposed action mit einer der possible actions zu überschreiben.
Wenn Sie eine Drop-Aktion festlegen, die nicht zu den möglichen Aktionen gehört, wird der Drag&Drop-Vorgang standardmäßig als Kopiervorgang ausgeführt.
Sobald Sie eine Ersatz-Aktion angegeben haben, rufen Sie accept() anstelle von acceptProposedAction() auf.
Siehe auch dropAction().
QObject *QDropEvent::source() const
Wenn die Quelle des Ziehvorgangs ein Widget in dieser Anwendung ist, gibt diese Funktion diese Quelle zurück; andernfalls gibt sie nullptr zurück. Die Quelle des Vorgangs ist der erste Parameter des QDrag Objekts, das zum Ziehen verwendet wird.
Dies ist nützlich, wenn Ihr Widget ein spezielles Verhalten beim Ziehen auf sich selbst benötigt.
Siehe auch QDrag::QDrag().
© 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.
