QEventPoint Class
Die Klasse QEventPoint liefert Informationen über einen Punkt in einem QPointerEvent. Mehr....
| Kopfzeile: | #include <QEventPoint> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui)target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| Seit: | Qt 6.0 |
Öffentliche Typen
Eigenschaften
|
|
Öffentliche Funktionen
| QEventPoint(int pointId, QEventPoint::State state, const QPointF &scenePosition, const QPointF &globalPosition) | |
| QEventPoint(const QEventPoint &other) | |
| QEventPoint(QEventPoint &&other) | |
| ~QEventPoint() | |
| const QPointingDevice * | device() const |
| QSizeF | ellipseDiameters() const |
| QPointF | globalGrabPosition() const |
| QPointF | globalLastPosition() const |
| QPointF | globalPosition() const |
| QPointF | globalPressPosition() const |
| QPointF | grabPosition() const |
| int | id() const |
| bool | isAccepted() const |
| QPointF | lastPosition() const |
| ulong | lastTimestamp() const |
| QPointF | normalizedPosition() const |
| QPointF | position() const |
| QPointF | pressPosition() const |
| ulong | pressTimestamp() const |
| qreal | pressure() const |
| qreal | rotation() const |
| QPointF | sceneGrabPosition() const |
| QPointF | sceneLastPosition() const |
| QPointF | scenePosition() const |
| QPointF | scenePressPosition() const |
| void | setAccepted(bool accepted = true) |
| QEventPoint::State | state() const |
| qreal | timeHeld() const |
| ulong | timestamp() const |
| QPointingDeviceUniqueId | uniqueId() const |
| QVector2D | velocity() const |
| bool | operator!=(const QEventPoint &other) const |
| QEventPoint & | operator=(QEventPoint &&other) |
| QEventPoint & | operator=(const QEventPoint &other) |
| bool | operator==(const QEventPoint &other) const |
Dokumentation der Mitgliedstypen
enum QEventPoint::State
flags QEventPoint::States
Gibt den Zustand dieses Ereignispunktes an.
| Konstante | Wert | Beschreibung |
|---|---|---|
QEventPoint::Unknown | Qt::TouchPointUnknownState | Unbekannter Zustand. |
QEventPoint::Stationary | Qt::TouchPointStationary | Der Ereignispunkt hat sich nicht bewegt. |
QEventPoint::Pressed | Qt::TouchPointPressed | Der Berührungspunkt oder die Schaltfläche wurde gedrückt. |
QEventPoint::Updated | Qt::TouchPointMoved | Der Ereignispunkt wurde aktualisiert. |
QEventPoint::Released | Qt::TouchPointReleased | Der Berührungspunkt oder die Schaltfläche wurde losgelassen. |
Der Typ States ist ein Typedef für QFlags<State>. Er speichert eine ODER-Kombination von Statuswerten.
Dokumentation der Eigenschaft
accepted : bool
Diese Eigenschaft enthält den akzeptierten Status des Ereignispunkts.
In Widget-basierten Anwendungen wird diese Eigenschaft nicht verwendet, da es für ein Widget nur sinnvoll ist, einen kompletten QInputEvent zu akzeptieren oder abzulehnen.
In Qt Quick ist es jedoch normal, dass ein Element oder Ereignis-Handler nur die einzelnen Punkte in einer QTouchEvent akzeptiert, die tatsächlich an einer Geste teilnehmen, während andere Punkte an andere Elemente oder Handler übergeben werden können. Aus Gründen der Konsistenz gilt dies für alle QPointerEvent; und die Übergabe erfolgt erst, wenn alle Punkte in einer QPointerEvent akzeptiert wurden.
Zugriffsfunktionen:
| bool | isAccepted() const |
| void | setAccepted(bool accepted = true) |
Siehe auch QEvent::accepted.
[read-only] device : const QPointingDevice*
Diese Eigenschaft enthält das Zeigegerät, von dem dieser Ereignispunkt ausgeht.
Zugriffsfunktionen:
| const QPointingDevice * | device() const |
[read-only] ellipseDiameters : const QSizeF
Diese Eigenschaft enthält die Breite und Höhe der Begrenzungsellipse des Berührungspunkts.
Der Rückgabewert ist in logischen Pixeln angegeben. Die meisten Touchscreens erkennen die Form des Berührungspunktes nicht, und keine Mäuse oder Tablet-Geräte können sie erkennen, so dass eine Nullgröße der häufigste Wert ist. Auf einigen Touchscreens können die Durchmesser ungleich Null und immer gleich sein (die Ellipse wird als Kreis approximiert).
Zugriffsfunktionen:
| QSizeF | ellipseDiameters() const |
[read-only] globalGrabPosition : const QPointF
Diese Eigenschaft enthält die globale Position, an der dieser Punkt gegriffen wurde.
Die globale Position bezieht sich auf den Bildschirm oder den virtuellen Desktop.
Zugriffsfunktionen:
| QPointF | globalGrabPosition() const |
Siehe auch globalPosition, grabPosition, und sceneGrabPosition.
[read-only] globalLastPosition : const QPointF
Diese Eigenschaft enthält die globale Position dieses Punktes vom letzten Druck- oder Bewegungsereignis.
Die globale Position ist relativ zum Bildschirm oder virtuellen Desktop.
Zugriffsfunktionen:
| QPointF | globalLastPosition() const |
Siehe auch globalPosition, lastPosition, und sceneLastPosition.
[read-only] globalPosition : const QPointF
Diese Eigenschaft enthält die globale Position dieses Punktes.
Die globale Position bezieht sich auf den Bildschirm oder den virtuellen Desktop.
Zugriffsfunktionen:
| QPointF | globalPosition() const |
Siehe auch globalPressPosition, position, und scenePosition.
[read-only] globalPressPosition : const QPointF
Diese Eigenschaft enthält die globale Position, an der dieser Punkt gedrückt wurde.
Die globale Position bezieht sich auf den Bildschirm oder den virtuellen Desktop.
Zugriffsfunktionen:
| QPointF | globalPressPosition() const |
Siehe auch globalPosition, pressPosition, und scenePressPosition.
[read-only] grabPosition : const QPointF
Diese Eigenschaft enthält die Position, an der dieser Punkt gegriffen wurde.
Die Position ist relativ zu dem Widget oder Element, das das Ereignis empfangen hat.
Zugriffsfunktionen:
| QPointF | grabPosition() const |
Siehe auch position.
[read-only] id : const int
Diese Eigenschaft enthält die ID-Nummer dieses Ereignispunktes.
Hinweis: Gehen Sie nicht davon aus, dass ID-Nummern bei Null beginnen oder dass sie fortlaufend sind. Eine solche Annahme ist aufgrund der Funktionsweise der zugrunde liegenden Treiber oft falsch.
Zugriffsfunktionen:
| int | id() const |
[read-only] lastPosition : const QPointF
Diese Eigenschaft enthält die Position dieses Punktes nach dem letzten Druck- oder Bewegungsereignis.
Die Position ist relativ zu dem Widget oder Element, das das Ereignis empfangen hat.
Zugriffsfunktionen:
| QPointF | lastPosition() const |
Siehe auch position und pressPosition.
[read-only] lastTimestamp : const ulong
Diese Eigenschaft enthält die Zeit von der vorherigen QPointerEvent, die diesen Punkt enthielt.
Zugriffsfunktionen:
| ulong | lastTimestamp() const |
Siehe auch globalLastPosition.
[read-only] position : const QPointF
Diese Eigenschaft enthält die Position dieses Punktes.
Die Position ist relativ zu dem Widget oder Element, das das Ereignis empfangen hat.
Zugriffsfunktionen:
| QPointF | position() const |
[read-only] pressPosition : const QPointF
Diese Eigenschaft enthält die Position, an der dieser Punkt gedrückt wurde.
Die Position ist relativ zu dem Widget oder Element, das das Ereignis empfangen hat.
Zugriffsfunktionen:
| QPointF | pressPosition() const |
Siehe auch position.
[read-only] pressTimestamp : const ulong
Diese Eigenschaft enthält den letzten Zeitpunkt, an dem dieser Punkt gedrückt wurde.
Zugriffsfunktionen:
| ulong | pressTimestamp() const |
Siehe auch timestamp.
[read-only] pressure : const qreal
Diese Eigenschaft enthält den Druck dieses Punktes.
Der Rückgabewert liegt im Bereich von 0.0 bis 1.0.
Zugriffsfunktionen:
| qreal | pressure() const |
[read-only] rotation : const qreal
Diese Eigenschaft enthält die Winkelausrichtung dieses Punktes.
Der Rückgabewert wird in Grad angegeben, wobei Null (der Standardwert) bedeutet, dass der Finger, Token oder Stift nach oben zeigt, ein negativer Winkel bedeutet, dass er nach links gedreht ist, und ein positiver Winkel bedeutet, dass er nach rechts gedreht ist. Die meisten Touchscreens erkennen die Drehung nicht, daher ist Null der gebräuchlichste Wert.
Funktionen aufrufen:
| qreal | rotation() const |
[read-only] sceneGrabPosition : const QPointF
Diese Eigenschaft enthält die Position der Szene, an der dieser Punkt gegriffen wurde.
Die Szenenposition ist die Position relativ zu QQuickWindow, wenn sie in QQuickItem::event() behandelt wird, in QGraphicsScene Koordinaten, wenn sie durch eine Überschreibung von QGraphicsItem::touchEvent() behandelt wird, oder die Fensterposition in Widget-Anwendungen.
Zugriffsfunktionen:
| QPointF | sceneGrabPosition() const |
Siehe auch scenePosition, grabPosition, und globalGrabPosition.
[read-only] sceneLastPosition : const QPointF
Diese Eigenschaft enthält die Position dieses Punktes in der Szene, die sich aus dem letzten Druck- oder Bewegungsereignis ergibt.
Die Szenenposition ist die Position relativ zu QQuickWindow, wenn sie in QQuickItem::event() behandelt wird, in QGraphicsScene Koordinaten, wenn sie durch eine Überschreibung von QGraphicsItem::touchEvent() behandelt wird, oder die Fensterposition in Widget-Anwendungen.
Zugriffsfunktionen:
| QPointF | sceneLastPosition() const |
Siehe auch scenePosition und scenePressPosition.
[read-only] scenePosition : const QPointF
Diese Eigenschaft enthält die Szenenposition dieses Punktes.
Die Szenenposition ist die Position relativ zu QQuickWindow, wenn sie in QQuickItem::event() behandelt wird, in QGraphicsScene Koordinaten, wenn sie durch eine Überschreibung von QGraphicsItem::touchEvent() behandelt wird, oder die Fensterposition in Widget-Anwendungen.
Zugriffsfunktionen:
| QPointF | scenePosition() const |
Siehe auch scenePressPosition, position, und globalPosition.
[read-only] scenePressPosition : const QPointF
Diese Eigenschaft enthält die Position in der Szene, an der dieser Punkt gedrückt wurde.
Die Szenenposition ist die Position relativ zu QQuickWindow, wenn sie in QQuickItem::event() behandelt wird, in QGraphicsScene Koordinaten, wenn sie durch eine Überschreibung von QGraphicsItem::touchEvent() behandelt wird, oder die Fensterposition in Widget-Anwendungen.
Zugriffsfunktionen:
| QPointF | scenePressPosition() const |
Siehe auch scenePosition, pressPosition, und globalPressPosition.
[read-only] state : const State
Diese Eigenschaft enthält den aktuellen Zustand des Ereignispunkts.
Zugriffsfunktionen:
| QEventPoint::State | state() const |
[read-only] timeHeld : const qreal
Diese Eigenschaft enthält die Dauer in Sekunden, seit dieser Punkt gedrückt und nicht losgelassen wurde.
Zugriffsfunktionen:
| qreal | timeHeld() const |
Siehe auch pressTimestamp und timestamp.
[read-only] timestamp : const ulong
Diese Eigenschaft enthält den letzten Zeitpunkt, zu dem dieser Punkt in eine QPointerEvent aufgenommen wurde.
Zugriffsfunktionen:
| ulong | timestamp() const |
Siehe auch QPointerEvent::timestamp().
[read-only] uniqueId : const QPointingDeviceUniqueId
Diese Eigenschaft enthält die eindeutige ID dieses Punktes oder Tokens, falls vorhanden.
Sie ist oft ungültig (siehe isValid()), da Touchscreens Finger nicht eindeutig identifizieren können.
Wenn sie von einem QTabletEvent stammt, identifiziert sie die Seriennummer des verwendeten Stiftes.
Er kann ein bestimmtes Token (Referenzobjekt) identifizieren, wenn der TUIO-Treiber mit einem Touchscreen verwendet wird, der diese unterstützt.
Zugriffsfunktionen:
| QPointingDeviceUniqueId | uniqueId() const |
[read-only] velocity : const QVector2D
Diese Eigenschaft enthält einen Geschwindigkeitsvektor in Einheiten von Pixeln pro Sekunde im Koordinatensystem des Bildschirms oder Desktops.
Hinweis: Wenn die Fähigkeiten des Geräts QInputDevice::Velocity beinhalten, bedeutet dies, dass die Geschwindigkeit vom Betriebssystem kommt (vielleicht stellt die Touch-Hardware oder der Treiber sie bereit). Normalerweise ist die Fähigkeit Velocity jedoch nicht gesetzt, was bedeutet, dass die Geschwindigkeit von Qt berechnet wird, wobei ein einfacher Kalman-Filter verwendet wird, um eine geglättete Durchschnittsgeschwindigkeit anstelle eines momentanen Wertes zu liefern. Sie gibt an, wie schnell und in welche Richtung der Benutzer diesen Punkt in den letzten Ereignissen gezogen hat, wobei das jüngste Ereignis den stärksten Einfluss hat.
Zugriffsfunktionen:
| QVector2D | velocity() const |
Siehe auch QInputDevice::capabilities() und QInputEvent::device().
Dokumentation der Mitgliedsfunktionen
QEventPoint::QEventPoint(int pointId, QEventPoint::State state, const QPointF &scenePosition, const QPointF &globalPosition)
Konstruiert einen Ereignispunkt mit den angegebenen pointId, state, scenePosition und globalPosition.
[noexcept] QEventPoint::QEventPoint(const QEventPoint &other)
Konstruiert einen Ereignispunkt, indem es eine flache Kopie von other erstellt.
[noexcept] QEventPoint::QEventPoint(QEventPoint &&other)
Konstruiert einen Ereignispunkt durch Verschieben von other.
[noexcept] QEventPoint::~QEventPoint()
Zerstört den Ereignispunkt.
QPointF QEventPoint::normalizedPosition() const
Gibt die normalisierte Position dieses Punktes zurück.
Die Koordinaten werden berechnet, indem globalPosition() in den Raum von QInputDevice::availableVirtualGeometry() transformiert wird, d. h. (0, 0) ist die linke obere Ecke und (1, 1) die rechte untere Ecke.
Siehe auch globalPosition.
[noexcept] bool QEventPoint::operator!=(const QEventPoint &other) const
Gibt true zurück, wenn dieser Ereignispunkt nicht gleich other ist, ansonsten false.
[noexcept] QEventPoint &QEventPoint::operator=(QEventPoint &&other)
Verschieben - weist other dieser Ereignispunktinstanz zu.
[noexcept] QEventPoint &QEventPoint::operator=(const QEventPoint &other)
Weist other diesem Ereignispunkt zu und gibt einen Verweis auf diesen Ereignispunkt zurück.
[noexcept] bool QEventPoint::operator==(const QEventPoint &other) const
Gibt true zurück, wenn dieser Ereignispunkt gleich other ist, andernfalls wird false zurückgegeben.
© 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.
