QDragMoveEvent Class

Die Klasse QDragMoveEvent stellt ein Ereignis bereit, das während einer Drag&Drop-Aktion gesendet wird. Mehr...

Kopfzeile: #include <QDragMoveEvent>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui
Vererbt: QDropEvent
Vererbt von:

QDragEnterEvent

Öffentliche Funktionen

QDragMoveEvent(const QPoint &pos, Qt::DropActions actions, const QMimeData *data, Qt::MouseButtons buttons, Qt::KeyboardModifiers modifiers, QEvent::Type type = DragMove)
void accept(const QRect &rectangle)
void accept()
QRect answerRect() const
void ignore(const QRect &rectangle)
void ignore()

Detaillierte Beschreibung

Ein Widget empfängt wiederholt Drag-Move-Ereignisse, während sich das Ziehen innerhalb seiner Grenzen befindet, wenn es drop events und enter events annimmt. Das Widget sollte das Ereignis untersuchen, um zu sehen, welche Art von data es bereitstellt, und die Funktion accept() aufrufen, um den Drop zu akzeptieren, wenn dies angemessen ist.

Das von der Funktion answerRect() gelieferte Rechteck kann verwendet werden, um Tropfen auf bestimmte Teile des Widgets zu beschränken. So kann beispielsweise geprüft werden, ob das Rechteck die Geometrie eines bestimmten untergeordneten Widgets schneidet, und acceptProposedAction() nur dann aufgerufen werden, wenn dies der Fall ist.

Beachten Sie, dass diese Klasse den größten Teil ihrer Funktionalität von QDropEvent erbt.

Siehe auch QDragEnterEvent, QDragLeaveEvent, und QDropEvent.

Dokumentation der Mitgliedsfunktionen

QDragMoveEvent::QDragMoveEvent(const QPoint &pos, Qt::DropActions actions, const QMimeData *data, Qt::MouseButtons buttons, Qt::KeyboardModifiers modifiers, QEvent::Type type = DragMove)

Erzeugt ein QDragMoveEvent mit der erforderlichen type, das anzeigt, dass sich die Maus an der angegebenen Position pos innerhalb eines Widgets befindet.

Die Maus- und Tastaturzustände werden durch buttons und modifiers spezifiziert, und die actions beschreiben die möglichen Arten von Drag- und Drop-Operationen. Die Ziehdaten werden als MIME-kodierte Informationen in data übergeben.

Warnung: Versuchen Sie nicht, selbst ein QDragMoveEvent zu erstellen. Diese Objekte verlassen sich auf den internen Zustand von Qt.

void QDragMoveEvent::accept(const QRect &rectangle)

Dasselbe wie accept(), aber zusätzlich mit dem Hinweis, dass künftige Züge ebenfalls akzeptiert werden, wenn sie innerhalb der für das Widget angegebenen rectangle bleiben. Dies kann die Leistung verbessern, kann aber auch vom zugrunde liegenden System ignoriert werden.

Wenn das Rechteck leer ist, werden Drag-Move-Ereignisse kontinuierlich gesendet. Dies ist nützlich, wenn die Quelle in einem Timer-Ereignis scrollt.

void QDragMoveEvent::accept()

Dies ist eine überladene Funktion.

Ruft QDropEvent::accept() auf.

QRect QDragMoveEvent::answerRect() const

Gibt das Rechteck im Widget zurück, in dem der Drop stattfinden wird, wenn er akzeptiert wird. Sie können diese Informationen verwenden, um Dropouts auf bestimmte Stellen des Widgets zu beschränken.

void QDragMoveEvent::ignore(const QRect &rectangle)

Das Gegenteil der Funktion accept(const QRect&). Bewegungen innerhalb der rectangle sind nicht akzeptabel und werden ignoriert.

void QDragMoveEvent::ignore()

Dies ist eine überladene Funktion.

Ruft QDropEvent::ignore() auf.

© 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.