QTouchEvent Class

Detaillierte Beschreibung

Aktivieren von Berührungsereignissen

Berührungsereignisse treten auf, wenn ein oder mehrere Berührungspunkte auf einem Berührungsgerät (z. B. einem Touchscreen oder Trackpad) gedrückt, losgelassen oder bewegt werden. Um Berührungsereignisse zu empfangen, muss bei Widgets das Attribut Qt::WA_AcceptTouchEvents und bei Grafikelementen das Attribut acceptTouchEvents auf true gesetzt sein.

Wenn Sie QAbstractScrollArea basierte Widgets verwenden, sollten Sie das Qt::WA_AcceptTouchEvents Attribut auf dem viewport des Scrollbereichs aktivieren.

Ähnlich wie bei QMouseEvent erfasst Qt automatisch jeden Berührungspunkt beim ersten Drücken innerhalb eines Widgets, und das Widget erhält alle Aktualisierungen für den Berührungspunkt, bis er losgelassen wird. Beachten Sie, dass es möglich ist, dass ein Widget Ereignisse für zahlreiche Berührungspunkte empfängt, und dass mehrere Widgets gleichzeitig Berührungsereignisse empfangen können.

Ereignisbehandlung

Alle Berührungsereignisse sind vom Typ QEvent::TouchBegin, QEvent::TouchUpdate, QEvent::TouchEnd oder QEvent::TouchCancel. Reimplementieren Sie QWidget::event() oder QAbstractScrollArea::viewportEvent() für Widgets und QGraphicsItem::sceneEvent() für Elemente in einer Grafikansicht, um Berührungsereignisse zu empfangen.

Im Gegensatz zu Widgets empfangen QWindows Berührungsereignisse immer, es besteht keine Notwendigkeit, sich dafür zu entscheiden. Wenn Sie direkt mit QWindow arbeiten, genügt es, QWindow::touchEvent() zu reimplementieren.

Die Ereignisse QEvent::TouchUpdate und QEvent::TouchEnd werden an das Widget oder Element gesendet, das das Ereignis QEvent::TouchBegin akzeptiert hat. Wenn das QEvent::TouchBegin Ereignis nicht akzeptiert und nicht durch einen Ereignisfilter gefiltert wird, werden bis zum nächsten QEvent::TouchBegin keine weiteren Berührungsereignisse gesendet.

Einige Systeme können ein Ereignis des Typs QEvent::TouchCancel senden. Beim Empfang dieses Ereignisses werden die Anwendungen aufgefordert, die gesamte aktive Berührungssequenz zu ignorieren. In einem zusammengesetzten System kann der Compositor zum Beispiel entscheiden, bestimmte Gesten als systemweite Gesten zu behandeln. Wann immer eine solche Entscheidung getroffen wird (die Geste wird erkannt), werden die Clients mit einem QEvent::TouchCancel -Ereignis benachrichtigt, damit sie ihren Status entsprechend aktualisieren können.

Die Funktionen pointCount() und point() können verwendet werden, um auf einzelne Berührungspunkte zuzugreifen und diese zu wiederholen.

Die Funktion points() gibt eine Liste aller im Ereignis enthaltenen Berührungspunkte zurück. Beachten Sie, dass diese Liste leer sein kann, zum Beispiel im Falle eines QEvent::TouchCancel Ereignisses. Jeder Punkt ist eine Instanz der Klasse QEventPoint. Das QEventPoint::State enum beschreibt die verschiedenen Zustände, die ein Berührungspunkt haben kann.

Ereigniszustellung und -weiterleitung

Standardmäßig übersetzt QGuiApplication den ersten Berührungspunkt in einem QTouchEvent in ein QMouseEvent. Dies ermöglicht die Aktivierung von Berührungsereignissen in bestehenden Widgets, die normalerweise nicht mit QTouchEvent umgehen. Siehe unten für Informationen über einige spezielle Überlegungen, die in diesem Fall notwendig sind.

QEvent::TouchBegin ist das erste Berührungsereignis, das an ein Widget gesendet wird. Das Ereignis QEvent::TouchBegin enthält ein spezielles Akzeptieren-Flag, das anzeigt, ob der Empfänger das Ereignis wünscht. Standardmäßig wird das Ereignis akzeptiert. Sie sollten ignore() aufrufen, wenn das Berührungsereignis nicht von Ihrem Widget verarbeitet wird. Das Ereignis QEvent::TouchBegin wird in der Kette der übergeordneten Widgets weitergegeben, bis ein Widget es mit accept() annimmt oder ein Ereignisfilter es verbraucht. Bei QGraphicsItems wird das QEvent::TouchBegin Ereignis an Elemente unter der Maus weitergegeben (ähnlich der Weitergabe von Mausereignissen bei QGraphicsItems).

Gruppierung von Berührungspunkten

Wie bereits erwähnt, ist es möglich, dass mehrere Widgets gleichzeitig QTouchEvents empfangen können. Qt stellt jedoch sicher, dass niemals doppelte QEvent::TouchBegin Ereignisse an dasselbe Widget gesendet werden, was theoretisch während der Ausbreitung passieren könnte, wenn z.B. der Benutzer 2 verschiedene Widgets in einem QGroupBox berührt und beide Widgets das QEvent::TouchBegin Ereignis ignorieren.

Um dies zu vermeiden, gruppiert Qt neue Berührungspunkte nach den folgenden Regeln:

• Wenn der erste Berührungspunkt erkannt wird, wird das Ziel-Widget erstens durch die Position auf dem Bildschirm und zweitens durch die Ausbreitungsregeln bestimmt.
• Wenn weitere Berührungspunkte erkannt werden, prüft Qt zunächst, ob es aktive Berührungspunkte auf einem Vorfahren oder Nachfahren des Widgets unter dem neuen Berührungspunkt gibt. Wenn dies der Fall ist, wird der neue Berührungspunkt mit dem ersten gruppiert und der neue Berührungspunkt wird in einem einzigen QTouchEvent an das Widget gesendet, das den ersten Berührungspunkt bearbeitet hat. (Das Widget unter dem neuen Berührungspunkt wird kein Ereignis erhalten).

Dies ermöglicht es Geschwister-Widgets, Berührungsereignisse unabhängig voneinander zu behandeln und stellt sicher, dass die Reihenfolge der QTouchEvents immer korrekt ist.

Mausereignisse und Synthese von Berührungsereignissen

Die Zustellung von QTouchEvents ist unabhängig von der von QMouseEvent. Die Anwendungsflags Qt::AA_SynthesizeTouchForUnhandledMouseEvents und Qt::AA_SynthesizeMouseForUnhandledTouchEvents können verwendet werden, um die automatische Synthese von Berührungsereignissen zu Mausereignissen und Mausereignissen zu Berührungsereignissen zu aktivieren oder zu deaktivieren.

Vorbehalte

• Wie oben erwähnt, bedeutet die Aktivierung von Berührungsereignissen, dass mehrere Widgets gleichzeitig Berührungsereignisse empfangen können. In Kombination mit der standardmäßigen QWidget::event()-Behandlung von QTouchEvents bietet dies eine große Flexibilität bei der Gestaltung von Touch-Benutzeroberflächen. Seien Sie sich der Auswirkungen bewusst. Es ist zum Beispiel möglich, dass der Benutzer ein QSlider mit einem Finger bewegt und ein QPushButton mit einem anderen drückt. Die von diesen Widgets ausgesendeten Signale werden sich überschneiden.
• Eine Rekursion in die Ereignisschleife mit einer der exec()-Methoden (z. B. QDialog::exec() oder QMenu::exec()) in einem QTouchEvent-Event-Handler wird nicht unterstützt. Da es mehrere Ereignisempfänger gibt, kann die Rekursion Probleme verursachen, einschließlich, aber nicht beschränkt auf verlorene Ereignisse und unerwartete unendliche Rekursion.
• QTouchEvents werden nicht von mouse grab oder active pop-up widget beeinflusst. Das Verhalten von QTouchEvents ist undefiniert, wenn ein Pop-up geöffnet oder die Maus angefasst wird, während mehr als ein aktiver Berührungspunkt vorhanden ist.