QGestureEvent Class
Die Klasse „QGestureEvent“ enthält die Beschreibung der ausgelösten Gesten. Mehr...
| Header: | #include <QGestureEvent> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Erbt von: | QEvent |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QGestureEvent gehört zu den Ereignisklassen.
Öffentliche Funktionen
| QGestureEvent(const QList<QGesture *> &gestures) | |
| virtual | ~QGestureEvent() |
| void | accept(QGesture *gesture) |
| void | accept(Qt::GestureType gestureType) |
| QList<QGesture *> | activeGestures() const |
| QList<QGesture *> | canceledGestures() const |
| QGesture * | gesture(Qt::GestureType type) const |
| QList<QGesture *> | gestures() const |
| void | ignore(QGesture *gesture) |
| void | ignore(Qt::GestureType gestureType) |
| bool | isAccepted(QGesture *gesture) const |
| bool | isAccepted(Qt::GestureType gestureType) const |
| QPointF | mapToGraphicsScene(const QPointF &gesturePoint) const |
| void | setAccepted(QGesture *gesture, bool value) |
| void | setAccepted(Qt::GestureType gestureType, bool value) |
| QWidget * | widget() const |
Ausführliche Beschreibung
Die Klasse „QGestureEvent“ enthält eine Liste von Gesten, die mithilfe der Funktion „ gestures()“ abgerufen werden kann.
Die Gesten sind entweder aktiv oder wurden abgebrochen. Eine Liste der derzeit ausgeführten Gesten kann mithilfe der Funktion „ activeGestures()“ abgerufen werden. Eine Liste der zuvor aktiven und inzwischen abgebrochenen Gesten kann mithilfe der Funktion „ canceledGestures()“ abgerufen werden. Eine Geste kann beispielsweise abgebrochen werden, wenn das aktuelle Fenster den Fokus verliert, aufgrund eines Timeouts oder aus anderen Gründen.
Wenn der Ereignis-Handler das Ereignis nicht durch Aufruf der generischen Funktion ` QEvent::accept()` akzeptiert, werden alle einzelnen ` QGesture `-Objekte, die nicht akzeptiert wurden und sich im Status ` Qt::GestureStarted ` befinden, entlang der übergeordneten Widget-Kette weitergegeben, bis ein Widget sie einzeln akzeptiert, indem es für jedes einzelne ` QGestureEvent::accept()` aufruft, oder bis ein Ereignisfilter das Ereignis verarbeitet.
Weiterführende Literatur
Einen Überblick über die Gestenverarbeitung in Qt sowie Informationen zur Verwendung von Gesten in Ihren Anwendungen finden Sie im Dokument „Gestures in Widgets and Graphics View “.
Siehe auch „ QGesture“ , „ QGestureRecognizer “, „ QWidget::grabGesture()“ und „ QGraphicsObject::grabGesture()“.
Dokumentation zu Mitgliedsfunktionen
[explicit] QGestureEvent::QGestureEvent(const QList<QGesture *> &gestures)
Erstellt ein neues `QGestureEvent`, das eine Liste von ` gestures` enthält.
[virtual noexcept] QGestureEvent::~QGestureEvent()
Löscht „ QGestureEvent “.
void QGestureEvent::accept(QGesture *gesture)
Setzt das „accept“-Flag des angegebenen „ gesture “-Objekts; dies entspricht dem Aufruf von „ setAccepted(gesture, true)“.
Das Setzen des „accept“-Flags zeigt an, dass der Ereignisempfänger die Geste akzeptiert. Unerwünschte Gesten können an das übergeordnete Widget weitergeleitet werden.
Siehe auch ` QGestureEvent::ignore()`.
void QGestureEvent::accept(Qt::GestureType gestureType)
Setzt das „accept“-Flag des angegebenen „ gestureType “ – dies entspricht dem Aufruf von „ setAccepted(gestureType, true)“.
Das Setzen des „accept“-Flags zeigt an, dass der Ereignisempfänger die Geste akzeptiert. Unerwünschte Gesten können an das übergeordnete Widget weitergeleitet werden.
Siehe auch ` QGestureEvent::ignore()`.
QList<QGesture *> QGestureEvent::activeGestures() const
Gibt eine Liste der aktiven (nicht abgebrochenen) Gesten zurück.
QList<QGesture *> QGestureEvent::canceledGestures() const
Gibt eine Liste der abgebrochenen Gesten zurück.
QGesture *QGestureEvent::gesture(Qt::GestureType type) const
Gibt ein Gestenobjekt zurück, das mit „ type “ erstellt wurde.
QList<QGesture *> QGestureEvent::gestures() const
Gibt alle Gesten zurück, die im Ereignis übermittelt werden.
void QGestureEvent::ignore(QGesture *gesture)
Löscht den Parameter „accept flag“ des angegebenen „ gesture “-Objekts; dies entspricht dem Aufruf von „ setAccepted(gesture, false)“.
Das Zurücksetzen des „accept“-Flags zeigt an, dass der Ereignisempfänger die Geste nicht akzeptiert. Unerwünschte Gesten können an das übergeordnete Widget weitergeleitet werden.
Siehe auch ` QGestureEvent::accept()`.
void QGestureEvent::ignore(Qt::GestureType gestureType)
Löscht den Parameter „accept flag“ des angegebenen „ gestureType “ – dies entspricht dem Aufruf von „ setAccepted(gesture, false)“.
Das Zurücksetzen des „accept“-Flags zeigt an, dass der Ereignisempfänger die Geste nicht akzeptiert. Unerwünschte Gesten können an das übergeordnete Widget weitergeleitet werden.
Siehe auch ` QGestureEvent::accept()`.
bool QGestureEvent::isAccepted(QGesture *gesture) const
Gibt „ true “ zurück, wenn die „ gesture “ akzeptiert wird; andernfalls wird „ false “ zurückgegeben.
bool QGestureEvent::isAccepted(Qt::GestureType gestureType) const
Gibt „ true “ zurück, wenn die Geste vom Typ „ gestureType “ akzeptiert wird; andernfalls wird „ false “ zurückgegeben.
QPointF QGestureEvent::mapToGraphicsScene(const QPointF &gesturePoint) const
Gibt die szenelokalen Koordinaten zurück, wenn sich das „ gesturePoint “ innerhalb einer Grafikansicht befindet.
Diese Funktion kann nützlich sein, wenn ein Gestenereignis an ein „ QGraphicsObject “ übermittelt wird, um einen Punkt in Bildschirmkoordinaten in szenenlokale Koordinaten umzuwandeln.
Siehe auch ` QPointF::isNull()`.
void QGestureEvent::setAccepted(QGesture *gesture, bool value)
Setzt das „accept“-Flag des angegebenen „ gesture “-Objekts auf den angegebenen „ value “.
Das Setzen des Akzeptanz-Flags zeigt an, dass der Ereignisempfänger das „ gesture “ wünscht. Unerwünschte Gesten können an das übergeordnete Widget weitergeleitet werden.
Standardmäßig werden Gesten in Ereignissen vom Typ „ QEvent::Gesture “ akzeptiert, während Gesten in „ QEvent::GestureOverride “-Ereignissen ignoriert werden.
Der Einfachheit halber kann das Akzeptanzflag auch mit ` accept(gesture)` gesetzt und mit ` ignore(gesture)` zurückgesetzt werden.
Siehe auch ` isAccepted()`.
void QGestureEvent::setAccepted(Qt::GestureType gestureType, bool value)
Setzt das „accept“-Flag des angegebenen „ gestureType “-Objekts auf den angegebenen Wert „ value “.
Das Setzen des Akzeptanz-Flags zeigt an, dass der Ereignisempfänger Gesten des angegebenen Typs, „ gestureType “, empfangen möchte. Unerwünschte Gesten können an das übergeordnete Widget weitergeleitet werden.
Standardmäßig werden Gesten in Ereignissen vom Typ „ QEvent::Gesture “ akzeptiert, während Gesten in „ QEvent::GestureOverride “-Ereignissen ignoriert werden.
Der Einfachheit halber kann das „accept“-Flag auch mit „ accept “ (gestureType) gesetzt und mit „ ignore “ (gestureType) zurückgesetzt werden.
QWidget *QGestureEvent::widget() const
Gibt das Widget zurück, bei dem das Ereignis aufgetreten ist.
© 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.
