QGestureRecognizer Class

Ausführliche Beschreibung

Gesten-Erkennungsmodule sind für die Erstellung und Verwaltung von „ QGesture “-Objekten sowie für die Überwachung von Eingabeereignissen zuständig, die an die Unterklassen „ QWidget “ und „ QGraphicsObject “ gesendet werden. „QGestureRecognizer“ ist die Basisklasse für die Implementierung benutzerdefinierter Gesten.

Entwickler, die lediglich die Gestenerkennung für Standardgesten bereitstellen müssen, müssen diese Klasse nicht direkt verwenden. Instanzen werden vom Framework im Hintergrund erstellt.

Einen Überblick über die Gestenverarbeitung in Qt sowie Informationen zur Verwendung von Gesten in Ihren Anwendungen finden Sie im Dokument „Gesten in Widgets und der Grafikansicht “.

Erkennen von Gesten

Der Prozess der Gestenerkennung umfasst das Filtern von Eingabeereignissen, die an bestimmte Objekte gesendet werden, sowie das Anpassen der zugehörigen „ QGesture “-Objekte, um relevante Informationen über die Benutzereingabe einzubeziehen.

Gesten werden erzeugt, wenn das Framework ` create()` aufruft, um Benutzereingaben für eine bestimmte Instanz einer Unterklasse von ` QWidget ` oder ` QGraphicsObject ` zu verarbeiten. Für jedes Widget oder Element, das für die Verwendung von Gesten konfiguriert ist, wird ein ` QGesture `-Objekt erstellt.

Sobald ein ` QGesture ` für ein Zielobjekt erstellt wurde, empfängt der Gestenerkennungsmechanismus Ereignisse dafür in seiner ` recognize()`-Handlerfunktion.

Wird eine Geste abgebrochen, wird die Funktion ` reset()` aufgerufen, wodurch der Erkenner die Möglichkeit erhält, die entsprechenden Eigenschaften im zugehörigen ` QGesture `-Objekt zu aktualisieren.

Unterstützung neuer Gesten

Um Unterstützung für neue Gesten hinzuzufügen, müssen Sie von `QGestureRecognizer` ableiten, um eine benutzerdefinierte Erkennungsklasse zu erstellen, eine Instanz dieser Klasse zu konstruieren und sie durch Aufruf von ` QGestureRecognizer::registerRecognizer()` bei der Anwendung zu registrieren. Sie können auch eine Unterklasse von ` QGesture ` erstellen, um eine benutzerdefinierte Gestenklasse zu definieren, oder auf dynamische Eigenschaften zurückgreifen, um spezifische Details der zu verarbeitenden Geste auszudrücken.

Ihre benutzerdefinierte QGestureRecognizer-Unterklasse muss die Funktion ` recognize()` neu implementieren, um die eingehenden Eingabeereignisse für Unterklassen von ` QWidget ` und ` QGraphicsObject ` zu verarbeiten und zu filtern. Obwohl die Logik für die Gestenerkennung in dieser Funktion implementiert ist, können Sie dauerhafte Informationen über den Status des Erkennungsprozesses im bereitgestellten ` QGesture `-Objekt speichern. Die Funktion ` recognize()` muss einen Wert vom Typ ` QGestureRecognizer::Result ` zurückgeben, der den Erkennungsstatus für eine bestimmte Geste und ein bestimmtes Zielobjekt angibt. Dies bestimmt, ob ein Gestenereignis an ein Zielobjekt weitergeleitet wird oder nicht.

Wenn Sie eine Geste durch eine benutzerdefinierte Unterklasse von ` QGesture ` darstellen möchten, müssen Sie die Funktion ` create()` neu implementieren, um Instanzen Ihrer Geste-Klasse zu erstellen. Ebenso müssen Sie möglicherweise die Funktion ` reset()` neu implementieren, falls Ihre benutzerdefinierten Geste-Objekte bei Abbruch einer Geste speziell behandelt werden müssen.