QDropEvent Class
Die Klasse „QDropEvent“ stellt ein Ereignis bereit, das ausgelöst wird, wenn eine Drag-and-Drop-Aktion abgeschlossen ist. Mehr...
| Header: | #include <QDropEvent> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| Erbt von: | QEvent |
| Vererbt an: |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- Veraltete Mitglieder
- QDropEvent ist Teil der Ereignisklassen.
Ö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 |
Geschützte Funktionen
| QDropEvent(QDropEvent &&) | |
| QDropEvent & | operator=(QDropEvent &&) |
| QDropEvent & | operator=(const QDropEvent &other) |
Ausführliche Beschreibung
Wenn ein Widget „ accepts drop events “ auslöst, erhält es dieses Ereignis, sofern es das zuletzt an es gesendete „ QDragEnterEvent “ oder „ QDragMoveEvent “ akzeptiert hat.
Das Drop-Ereignis enthält eine vorgeschlagene Aktion, die über ` proposedAction()` abgerufen werden kann und die das Widget entweder akzeptieren 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, ist es möglicherweise sinnvoll, entweder einen dieser Werte als Standardaktion auszuwählen oder den Benutzer aufzufordern, seine bevorzugte Aktion auszuwählen.
Wenn die vorgeschlagene Ablageaktion nicht geeignet ist – beispielsweise, weil Ihr benutzerdefiniertes Widget diese Aktion nicht unterstützt –, können Sie sie durch eine der Aktionen aus „ possible drop actions “ ersetzen, indem Sie „ setDropAction()“ mit Ihrer bevorzugten Aktion aufrufen. Wenn Sie einen Wert festlegen, der nicht in der bitweisen ODER-Kombination der von ` possibleActions()` zurückgegebenen Werte enthalten ist, wird die Standard-Kopieraktion verwendet. Sobald eine Ersatz-Ablegeaktion festgelegt wurde, rufen Sie ` accept()` anstelle von ` acceptProposedAction()` auf, um den Ablegevorgang abzuschließen.
Die Funktion „ mimeData()“ stellt die auf das Widget abgelegten Daten in einem „ QMimeData “-Objekt bereit. Dieses enthält neben den Daten selbst auch Informationen zum MIME-Typ der Daten.
Siehe auch „ QMimeData “, „ QDrag “ und „Drag and Drop“.
Dokumentation zu Mitgliedsfunktionen
QDropEvent::QDropEvent(const QPointF &pos, Qt::DropActions actions, const QMimeData *data, Qt::MouseButtons buttons, Qt::KeyboardModifiers modifiers, QEvent::Type type = Drop)
Erzeugt 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-and-Drop-Vorgängen 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.
[protected delete] QDropEvent::QDropEvent(QDropEvent &&)
Erstellt eine Instanz von ` QDropEvent`. Diese Funktion wurde gelöscht.
void QDropEvent::acceptProposedAction()
Legt die Aktion beim Ablegen auf die vorgeschlagene Aktion fest.
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 ausführen soll. Diese kann sich von der in ` proposedAction()` übergebenen Aktion unterscheiden, wenn Sie ` setDropAction()` aufgerufen haben, um explizit eine „Drop“-Aktion auszuwählen.
Siehe auch ` setDropAction()`.
const QMimeData *QDropEvent::mimeData() const
Gibt die Daten zurück, die auf das Widget gezogen wurden, sowie die zugehörigen MIME-Typ-Informationen.
[since 6.0] Qt::KeyboardModifiers QDropEvent::modifiers() const
Gibt die gedrückten Modifikatortasten 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 Drop durchgeführt wurde.
Diese Funktion wurde in Qt 6.0 eingeführt.
Qt::DropActions QDropEvent::possibleActions() const
Gibt eine OR-Kombination möglicher Drop-Aktionen zurück.
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 diese Option, um die „ proposed action “ durch eine der „ possible actions “ zu überschreiben.
Wenn Sie eine Drop-Aktion festlegen, die nicht zu den möglichen Aktionen gehört, wird der Drag-and-Drop-Vorgang standardmäßig als Kopiervorgang ausgeführt.
Sobald Sie eine Ersatz-Ablegeaktion angegeben haben, rufen Sie „ accept()“ anstelle von „ acceptProposedAction()“ auf.
Siehe auch dropAction().
QObject *QDropEvent::source() const
Wenn die Quelle des Drag-Vorgangs 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 zur Instanziierung des Drag-Vorgangs verwendet wurde.
Dies ist nützlich, wenn Ihr Widget beim Ziehen auf sich selbst ein spezielles Verhalten benötigt.
Siehe auch ` QDrag::QDrag()`.
[protected delete] QDropEvent &QDropEvent::operator=(QDropEvent &&)
Weist „ other “ dieser „ QDropEvent “-Instanz zu. Diese Funktion wird gelöscht.
[noexcept protected default] QDropEvent &QDropEvent::operator=(const QDropEvent &other)
other Weist dieser Instanz von „ QDropEvent “ den Wert „ “ zu. “ zu dieser Instanz von „ “ zu.
© 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.
