QGestureRecognizer Class

Detaillierte Beschreibung

Gestenerkenner sind verantwortlich für die Erstellung und Verwaltung von QGesture Objekten und die Überwachung von Eingabeereignissen, die an QWidget und QGraphicsObject Unterklassen gesendet werden. QGestureRecognizer ist die Basisklasse für die Implementierung eigener Gesten.

Entwickler, die nur eine Gestenerkennung für Standardgesten benötigen, müssen diese Klasse nicht direkt verwenden. Instanzen werden hinter den Kulissen durch das Framework erstellt.

Einen Überblick über die Handhabung von Gesten in Qt und Informationen zur Verwendung von Gesten in Ihren Anwendungen finden Sie im Dokument Gesten in Widgets und Grafikansichten.

Erkennung von Gesten

Der Prozess der Erkennung von Gesten beinhaltet das Filtern von Eingabeereignissen, die an bestimmte Objekte gesendet werden, und das Ändern der zugehörigen QGesture Objekte, um relevante Informationen über die Benutzereingabe aufzunehmen.

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

Sobald ein QGesture für ein Zielobjekt erstellt wurde, empfängt der Gestenerkenner Ereignisse für dieses Objekt in seiner recognize() Handler-Funktion.

Wenn eine Geste abgebrochen wird, wird die Funktion reset() aufgerufen, was dem Erkenner die Möglichkeit gibt, die entsprechenden Eigenschaften im entsprechenden QGesture Objekt zu aktualisieren.

Unterstützung für neue Gesten

Um Unterstützung für neue Gesten hinzuzufügen, müssen Sie von QGestureRecognizer ableiten, um eine benutzerdefinierte Erkennerklasse zu erstellen, eine Instanz dieser Klasse zu erzeugen und sie mit der Anwendung zu registrieren, indem Sie QGestureRecognizer::registerRecognizer() aufrufen. Sie können auch eine Unterklasse von QGesture erstellen, um eine benutzerdefinierte Gestenklasse zu erstellen, oder sich auf dynamische Eigenschaften verlassen, um spezifische Details der Geste auszudrücken, die Sie behandeln möchten.

Ihre benutzerdefinierte QGestureRecognizer-Unterklasse muss die Funktion recognize() reimplementieren, um die eingehenden Eingabeereignisse für die Unterklassen 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 Zustand des Erkennungsprozesses in dem mitgelieferten QGesture Objekt speichern. Die Funktion recognize() muss einen Wert von QGestureRecognizer::Result zurückgeben, der den Zustand der Erkennung für eine bestimmte Geste und ein bestimmtes Zielobjekt angibt. Dies bestimmt, ob ein Gestenereignis an ein Zielobjekt übermittelt wird oder nicht.

Wenn Sie eine Geste durch eine benutzerdefinierte QGesture Unterklasse darstellen möchten, müssen Sie die Funktion create() neu implementieren, um Instanzen Ihrer Gestenklasse zu erstellen. In ähnlicher Weise müssen Sie die Funktion reset() neu implementieren, wenn Ihre benutzerdefinierten Gestenobjekte speziell behandelt werden müssen, wenn eine Geste abgebrochen wird.