QEventPoint Class
La clase `QEventPoint` proporciona información sobre un punto en un ` QPointerEvent`. Más información...
| Encabezado: | #include <QEventPoint> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| Desde: | Qt 6.0 |
Tipos públicos
Propiedades
|
|
Funciones públicas
| 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 |
Documentación sobre los tipos de miembros
enum QEventPoint::State
flags QEventPoint::States
Especifica el estado de este punto de evento.
| Constante | Valor | Descripción |
|---|---|---|
QEventPoint::Unknown | Qt::TouchPointUnknownState | Estado desconocido. |
QEventPoint::Stationary | Qt::TouchPointStationary | El punto de evento no se ha movido. |
QEventPoint::Pressed | Qt::TouchPointPressed | Se ha pulsado el punto táctil o el botón. |
QEventPoint::Updated | Qt::TouchPointMoved | El punto de evento se ha actualizado. |
QEventPoint::Released | Qt::TouchPointReleased | Se ha soltado el punto táctil o el botón. |
El tipo «States» es una definición de tipo (typedef) para QFlags<State>. Almacena una combinación OR de valores de «State».
Documentación de propiedades
accepted : bool
Esta propiedad contiene el estado de aceptación del punto de evento.
En aplicaciones basadas en widgets, esta propiedad no se utiliza, ya que solo tiene sentido que un widget acepte o rechace un QInputEvent completo.
Sin embargo, en Qt Quick, es habitual que un elemento (Item) o un controlador de eventos (Event Handler) acepte únicamente los puntos individuales de un conjunto de puntos ( QTouchEvent ) que participan realmente en un gesto, mientras que los demás puntos pueden enviarse a otros elementos o controladores. En aras de la coherencia, esto se aplica a cualquier conjunto de puntos ( QPointerEvent); y el envío solo se realiza cuando se han aceptado todos los puntos de un conjunto de puntos ( QPointerEvent ).
Funciones de acceso:
| bool | isAccepted() const |
| void | setAccepted(bool accepted = true) |
Véase también QEvent::accepted.
[read-only] device : const QPointingDevice*
Esta propiedad contiene el dispositivo de puntero del que procede este punto de evento.
Funciones de acceso:
| const QPointingDevice * | device() const |
[read-only] ellipseDiameters : const QSizeF
Esta propiedad contiene la anchura y la altura de la elipse delimitadora del punto de contacto.
El valor devuelto se expresa en píxeles lógicos. La mayoría de las pantallas táctiles no detectan la forma del punto de contacto, y ningún ratón ni tableta es capaz de detectarla, por lo que el valor más habitual es un tamaño nulo. En algunas pantallas táctiles, los diámetros pueden ser distintos de cero y siempre iguales (la elipse se aproxima a un círculo).
Funciones de acceso:
| QSizeF | ellipseDiameters() const |
[read-only] globalGrabPosition : const QPointF
Esta propiedad contiene la posición global en la que se seleccionó este punto.
La posición global es relativa a la pantalla o al escritorio virtual.
Funciones de acceso:
| QPointF | globalGrabPosition() const |
Véase también globalPosition, grabPosition y sceneGrabPosition.
[read-only] globalLastPosition : const QPointF
Esta propiedad contiene la posición global de este punto en el momento del último evento de pulsación o desplazamiento.
La posición global es relativa a la pantalla o al escritorio virtual.
Funciones de acceso:
| QPointF | globalLastPosition() const |
Véase también globalPosition, lastPosition y sceneLastPosition.
[read-only] globalPosition : const QPointF
Esta propiedad contiene la posición global de este punto.
La posición global es relativa a la pantalla o al escritorio virtual.
Funciones de acceso:
| QPointF | globalPosition() const |
Véase también globalPressPosition, position y scenePosition.
[read-only] globalPressPosition : const QPointF
Esta propiedad contiene la posición global en la que se pulsó este punto.
La posición global es relativa a la pantalla o al escritorio virtual.
Funciones de acceso:
| QPointF | globalPressPosition() const |
Véase también globalPosition, pressPosition y scenePressPosition.
[read-only] grabPosition : const QPointF
Esta propiedad contiene la posición en la que se seleccionó este punto.
La posición es relativa al widget o elemento que recibió el evento.
Funciones de acceso:
| QPointF | grabPosition() const |
Véase también position.
[read-only] id : const int
Esta propiedad contiene el número de identificación de este punto de evento.
Nota: Nose debe dar por sentado que los números de identificación empiezan por cero ni que son secuenciales. Esa suposición suele ser errónea debido al funcionamiento de los controladores subyacentes.
Funciones de acceso:
| int | id() const |
[read-only] lastPosition : const QPointF
Esta propiedad contiene la posición de este punto en el momento del último evento de pulsación o desplazamiento.
La posición es relativa al widget o elemento que recibió el evento.
Funciones de acceso:
| QPointF | lastPosition() const |
Véase también position y pressPosition.
[read-only] lastTimestamp : const ulong
Esta propiedad contiene la hora de la última « QPointerEvent » que incluía este punto.
Funciones de acceso:
| ulong | lastTimestamp() const |
Véase también « globalLastPosition ».
[read-only] position : const QPointF
Esta propiedad contiene la posición de este punto.
La posición es relativa al widget o elemento que recibió el evento.
Funciones de acceso:
| QPointF | position() const |
[read-only] pressPosition : const QPointF
Esta propiedad contiene la posición en la que se pulsó este punto.
La posición es relativa al widget o elemento que recibió el evento.
Funciones de acceso:
| QPointF | pressPosition() const |
Véase también position.
[read-only] pressTimestamp : const ulong
Esta propiedad contiene la hora más reciente en la que se pulsó este botón.
Funciones de acceso:
| ulong | pressTimestamp() const |
Véase también timestamp.
[read-only] pressure : const qreal
Esta propiedad contiene la presión de este punto.
El valor devuelto está comprendido entre 0.0 y 1.0.
Funciones de acceso:
| qreal | pressure() const |
[read-only] rotation : const qreal
Esta propiedad contiene la orientación angular de este punto.
El valor devuelto se expresa en grados, donde cero (el valor predeterminado) indica que el dedo, el dispositivo o el lápiz óptico apunta hacia arriba; un ángulo negativo significa que está girado hacia la izquierda, y un ángulo positivo significa que está girado hacia la derecha. La mayoría de las pantallas táctiles no detectan la rotación, por lo que cero es el valor más habitual.
Funciones de acceso:
| qreal | rotation() const |
[read-only] sceneGrabPosition : const QPointF
Esta propiedad contiene la posición en la escena en la que se capturó este punto.
La posición en la escena es la posición relativa a QQuickWindow si se gestiona en QQuickItem::event(), en coordenadas QGraphicsScene si se gestiona mediante una sobrescritura de QGraphicsItem::touchEvent(), o la posición de la ventana en aplicaciones de widgets.
Funciones de acceso:
| QPointF | sceneGrabPosition() const |
Véase también scenePosition, grabPosition y globalGrabPosition.
[read-only] sceneLastPosition : const QPointF
Esta propiedad contiene la posición de este punto en la escena, tal y como quedó tras el último evento de pulsación o desplazamiento.
La posición en la escena es la posición relativa a QQuickWindow si se gestiona en QQuickItem::event(), en coordenadas QGraphicsScene si se gestiona mediante una sobrescritura de QGraphicsItem::touchEvent(), o la posición de la ventana en aplicaciones de widgets.
Funciones de acceso:
| QPointF | sceneLastPosition() const |
Véase también ` scenePosition ` y ` scenePressPosition`.
[read-only] scenePosition : const QPointF
Esta propiedad contiene la posición de este punto en la escena.
La posición en la escena es la posición relativa a QQuickWindow si se gestiona en QQuickItem::event(), en coordenadas QGraphicsScene si se gestiona mediante una sobrescritura de QGraphicsItem::touchEvent(), o la posición de la ventana en aplicaciones de widgets.
Funciones de acceso:
| QPointF | scenePosition() const |
Véase también scenePressPosition, position y globalPosition.
[read-only] scenePressPosition : const QPointF
Esta propiedad almacena la posición en la escena en la que se pulsó este punto.
La posición en la escena es la posición relativa a QQuickWindow si se gestiona en QQuickItem::event(), en QGraphicsScene si se gestiona mediante una sobrescritura de QGraphicsItem::touchEvent(), o la posición de la ventana en aplicaciones de widgets.
Funciones de acceso:
| QPointF | scenePressPosition() const |
Véase también scenePosition, pressPosition y globalPressPosition.
[read-only] state : const State
Esta propiedad contiene el estado actual del punto de evento.
Funciones de acceso:
| QEventPoint::State | state() const |
[read-only] timeHeld : const qreal
Esta propiedad contiene la duración, en segundos, desde que se pulsó este punto y no se soltó.
Funciones de acceso:
| qreal | timeHeld() const |
Véase también pressTimestamp y timestamp.
[read-only] timestamp : const ulong
Esta propiedad contiene la hora más reciente en la que este punto se incluyó en un « QPointerEvent ».
Funciones de acceso:
| ulong | timestamp() const |
Véase también QPointerEvent::timestamp().
[read-only] uniqueId : const QPointingDeviceUniqueId
Esta propiedad contiene el identificador único de este punto o token, si lo hay.
A menudo no es válida (véase isValid()), ya que las pantallas táctiles no pueden identificar de forma unívoca los dedos.
Cuando procede de un QTabletEvent, identifica el número de serie del lápiz óptico que se está utilizando.
Puede identificar un token específico (objeto fiducial) cuando se utiliza el controlador TUIO con una pantalla táctil que los admita.
Funciones de acceso:
| QPointingDeviceUniqueId | uniqueId() const |
[read-only] velocity : const QVector2D
Esta propiedad contiene un vector de velocidad, en unidades de píxeles por segundo, en el sistema de coordenadas de la pantalla o el escritorio.
Nota: Si entre las capacidades del dispositivo se incluye « QInputDevice::Velocity », significa que la velocidad procede del sistema operativo (quizás la proporcione el hardware táctil o el controlador). Sin embargo, normalmente la capacidad « Velocity » no está activada, lo que indica que Qt calcula la velocidad utilizando un filtro de Kalman sencillo para proporcionar una velocidad media suavizada en lugar de un valor instantáneo. En la práctica, indica a qué velocidad y en qué dirección ha estado arrastrando el usuario este punto durante los últimos eventos, siendo el evento más reciente el que tiene mayor influencia.
Funciones de acceso:
| QVector2D | velocity() const |
Véase también QInputDevice::capabilities() y QInputEvent::device().
Documentación de las funciones miembro
QEventPoint::QEventPoint(int pointId, QEventPoint::State state, const QPointF &scenePosition, const QPointF &globalPosition)
Crea un punto de evento con los valores proporcionados: pointId, state, scenePosition y globalPosition.
[noexcept] QEventPoint::QEventPoint(const QEventPoint &other)
Crea un punto de evento realizando una copia superficial de ` other`.
[constexpr noexcept default] QEventPoint::QEventPoint(QEventPoint &&other)
Crea un punto de evento moviendo other.
[noexcept] QEventPoint::~QEventPoint()
Elimina el punto de evento.
QPointF QEventPoint::normalizedPosition() const
Devuelve la posición normalizada de este punto.
Las coordenadas se calculan transformando globalPosition() en el espacio de QInputDevice::availableVirtualGeometry(), es decir, (0, 0) es la esquina superior izquierda y (1, 1) es la esquina inferior derecha.
Véase también globalPosition.
[noexcept] bool QEventPoint::operator!=(const QEventPoint &other) const
Devuelve ` true ` si este punto de evento no es igual a ` other`; en caso contrario, devuelve ` false`.
[noexcept] QEventPoint &QEventPoint::operator=(QEventPoint &&other)
Asigna « other » a esta instancia de punto de evento.
[noexcept] QEventPoint &QEventPoint::operator=(const QEventPoint &other)
Asigna « other » a este punto de evento y devuelve una referencia a dicho punto de evento.
[noexcept] bool QEventPoint::operator==(const QEventPoint &other) const
Devuelve « true » si este punto de evento es igual a « other »; en caso contrario, devuelve « false ».
© 2026 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.