QGestureEvent Class
Die Klasse QGestureEvent liefert die Beschreibung von ausgelösten Gesten. Mehr...
| Kopfzeile: | #include <QGestureEvent> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Vererbt: | QEvent |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QGestureEvent ist Teil der Ereignis-Klassen.
Ö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 |
Detaillierte Beschreibung
Die Klasse QGestureEvent enthält eine Liste von Gesten, die mit der Funktion gestures() abgerufen werden können.
Die Gesten sind entweder aktiv oder abgebrochen. Eine Liste der Gesten, die gerade ausgeführt werden, kann mit der Funktion activeGestures() abgerufen werden. Eine Liste der Gesten, die zuvor aktiv waren und abgebrochen wurden, kann mit der Funktion canceledGestures() abgerufen werden. Eine Geste kann z. B. abgebrochen werden, wenn das aktuelle Fenster den Fokus verliert, oder wegen einer Zeitüberschreitung oder aus anderen Gründen.
Wenn der Ereignishandler das Ereignis nicht durch Aufruf der generischen Funktion QEvent::accept() annimmt, werden alle einzelnen QGesture Objekte, die nicht angenommen wurden und sich im Zustand Qt::GestureStarted befinden, in der Kette der übergeordneten Widgets weitergereicht, bis ein Widget sie einzeln annimmt, indem es QGestureEvent::accept() für jedes von ihnen aufruft, oder ein Ereignisfilter das Ereignis verbraucht.
Weitere Lektüre
Einen Überblick über die Handhabung von Gesten in Qt und Informationen über die Verwendung von Gesten in Ihren Anwendungen finden Sie im Dokument Gesten in Widgets und Grafikansicht.
Siehe auch QGesture, QGestureRecognizer, QWidget::grabGesture(), und QGraphicsObject::grabGesture().
Dokumentation der Mitgliedsfunktionen
[explicit] QGestureEvent::QGestureEvent(const QList<QGesture *> &gestures)
Erzeugt ein neues QGestureEvent mit einer Liste von gestures.
[virtual noexcept] QGestureEvent::~QGestureEvent()
Zerstört QGestureEvent.
void QGestureEvent::accept(QGesture *gesture)
Setzt das Akzeptieren-Flag des angegebenen gesture Objekts, was einem Aufruf von setAccepted(Geste, true) entspricht.
Das Setzen des Akzeptieren-Flags zeigt an, dass der Ereignisempfänger die Geste wünscht. Unerwünschte Gesten können an das übergeordnete Widget weitergegeben werden.
Siehe auch QGestureEvent::ignore().
void QGestureEvent::accept(Qt::GestureType gestureType)
Setzt das Akzeptieren-Flag der angegebenen gestureType, was dem Aufruf von setAccepted(gestureType, true) entspricht.
Das Setzen des Akzeptieren-Flags zeigt an, dass der Ereignisempfänger die Geste wünscht. Unerwünschte Gesten können an das übergeordnete Widget weitergegeben 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 über type zurück.
QList<QGesture *> QGestureEvent::gestures() const
Gibt alle Gesten zurück, die in dem Ereignis geliefert werden.
void QGestureEvent::ignore(QGesture *gesture)
Löscht den Parameter "Akzeptieren" des angegebenen gesture Objekts, was dem Aufruf von setAccepted(Geste, false) entspricht.
Das Löschen des Akzeptieren-Flags zeigt an, dass der Ereignisempfänger die Geste nicht wünscht. Unerwünschte Gesten können an das übergeordnete Widget weitergegeben werden.
Siehe auch QGestureEvent::accept().
void QGestureEvent::ignore(Qt::GestureType gestureType)
Löscht den Akzeptanz-Flag-Parameter der angegebenen gestureType, was dem Aufruf von setAccepted(Geste, false) entspricht.
Das Löschen des Akzeptieren-Flags zeigt an, dass der Ereignisempfänger die Geste nicht wünscht. Unerwünschte Gesten können an das übergeordnete Widget weitergegeben werden.
Siehe auch QGestureEvent::accept().
bool QGestureEvent::isAccepted(QGesture *gesture) const
Gibt true zurück, wenn 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 gesturePoint innerhalb einer Grafikansicht befindet.
Diese Funktion kann nützlich sein, wenn das Gesten-Ereignis an QGraphicsObject übergeben wird, um einen Punkt in Bildschirmkoordinaten in szenelokale Koordinaten zu übersetzen.
Siehe auch QPointF::isNull().
void QGestureEvent::setAccepted(QGesture *gesture, bool value)
Setzt das Akzeptieren-Flag des angegebenen gesture Objekts auf das angegebene value.
Das Setzen des Akzeptieren-Flags zeigt an, dass der Ereignisempfänger die gesture wünscht. Unerwünschte Gesten können an das übergeordnete Widget weitergegeben werden.
Standardmäßig werden Gesten in Ereignissen des Typs QEvent::Gesture akzeptiert, und Gesten in QEvent::GestureOverride Ereignissen werden ignoriert.
Der Einfachheit halber kann das Akzeptieren-Flag auch mit accept(Geste) gesetzt und mit ignore(Geste) wieder gelöscht werden.
Siehe auch isAccepted().
void QGestureEvent::setAccepted(Qt::GestureType gestureType, bool value)
Setzt das Akzeptieren-Flag des angegebenen gestureType Objekts auf den angegebenen value.
Das Setzen des Akzept-Flags zeigt an, dass der Ereignisempfänger Gesten des angegebenen Typs gestureType empfangen möchte. Unerwünschte Gesten können an das übergeordnete Widget weitergegeben werden.
Standardmäßig werden Gesten in Ereignissen des Typs QEvent::Gesture akzeptiert, und Gesten in QEvent::GestureOverride Ereignissen werden ignoriert.
Der Einfachheit halber kann das Akzeptieren-Flag auch mit accept(gestureType) gesetzt und mit ignore(gestureType) gelöscht werden.
QWidget *QGestureEvent::widget() const
Gibt das Widget zurück, bei dem das Ereignis aufgetreten ist.
© 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.
