QEventPoint Class
La clase QEventPoint proporciona información sobre un punto en un QPointerEvent. Más...
| Cabecera: | #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 de tipos de miembros
enum QEventPoint::Estado
banderas QEventPoint::Estados
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 de contacto o el botón. |
QEventPoint::Updated | Qt::TouchPointMoved | El punto de evento se actualizó. |
QEventPoint::Released | Qt::TouchPointReleased | El punto táctil o botón fue liberado. |
El tipo States es un typedef para QFlags<State>. Almacena una combinación OR de valores de Estado.
Documentación de Propiedades
accepted : bool
Esta propiedad contiene el estado aceptado del punto de evento.
En aplicaciones basadas en widgets, esta propiedad no se utiliza, ya que sólo tiene sentido que un widget acepte o rechace un QInputEvent completo.
En Qt Quick sin embargo, es normal que un Elemento o Manejador de Eventos acepte sólo los puntos individuales en un QTouchEvent que realmente están participando en un gesto, mientras que otros puntos pueden ser entregados a otros elementos o manejadores. En aras de la coherencia, esto se aplica a cualquier QPointerEvent; y la entrega se realiza sólo cuando todos los puntos de un QPointerEvent han sido aceptados.
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 señalador desde el que se origina 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 que delimita el punto táctil.
El valor devuelto está 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 o tableta puede detectarlo, por lo que un tamaño nulo es el valor más común. En algunas pantallas táctiles los diámetros pueden ser distintos de cero y siempre iguales (la elipse se aproxima como 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 tomó 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 desde el evento anterior de pulsar o mover.
La posición global es relativa a la pantalla o 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 este punto fue agarrado.
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 ID de este punto de evento.
Nota: No asuma que los números ID comienzan en cero o que son secuenciales. Tal suposición suele ser falsa debido a la forma en que funcionan los controladores subyacentes.
Funciones de acceso:
| int | id() const |
[read-only] lastPosition : const QPointF
Esta propiedad mantiene la posición de este punto desde el evento anterior de pulsar o mover.
La posición es relativa al widget o elemento que recibió el evento.
Funciones de acceso:
| QPointF | lastPosition() const |
Ver también position y pressPosition.
[read-only] lastTimestamp : const ulong
Esta propiedad contiene el tiempo de la anterior QPointerEvent que contení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 punto.
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 de retorno está en el rango 0.0 a 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 de retorno está en grados, donde cero (por defecto) indica que el dedo, token o stylus está apuntando 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 común.
Funciones de acceso:
| qreal | rotation() const |
[read-only] sceneGrabPosition : const QPointF
Esta propiedad contiene la posición de la escena en la que este punto fue agarrado.
La posición de la escena es la posición relativa a QQuickWindow si se maneja en QQuickItem::event(), en coordenadas QGraphicsScene si se maneja mediante un override de QGraphicsItem::touchEvent(), o la posición de la ventana en aplicaciones widget.
Funciones de acceso:
| QPointF | sceneGrabPosition() const |
Ver también scenePosition, grabPosition, y globalGrabPosition.
[read-only] sceneLastPosition : const QPointF
Esta propiedad contiene la posición en la escena de este punto desde el evento de pulsación o movimiento anterior.
La posición en la escena es la posición relativa a QQuickWindow si es manejado en QQuickItem::event(), en coordenadas QGraphicsScene si es manejado por un override de QGraphicsItem::touchEvent(), o la posición de la ventana en aplicaciones widget.
Funciones de acceso:
| QPointF | sceneLastPosition() const |
Véase también scenePosition y scenePressPosition.
[read-only] scenePosition : const QPointF
Esta propiedad contiene la posición en la escena de este punto.
La posición de la escena es la posición relativa a QQuickWindow si se maneja en QQuickItem::event(), en coordenadas QGraphicsScene si se maneja mediante un override de QGraphicsItem::touchEvent(), o la posición de la ventana en aplicaciones widget.
Funciones de acceso:
| QPointF | scenePosition() const |
Ver también scenePressPosition, position, y globalPosition.
[read-only] scenePressPosition : const QPointF
Esta propiedad contiene la posición de la escena en la que se pulsó este punto.
La posición de la escena es la posición relativa a QQuickWindow si se maneja en QQuickItem::event(), en coordenadas QGraphicsScene si se maneja mediante un override de QGraphicsItem::touchEvent(), o la posición de la ventana en aplicaciones widget.
Funciones de acceso:
| QPointF | scenePressPosition() const |
Ver 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 este punto se pulsó 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 fecha más reciente en la que este punto se incluyó en QPointerEvent.
Funciones de acceso:
| ulong | timestamp() const |
Véase también QPointerEvent::timestamp().
[read-only] uniqueId : const QPointingDeviceUniqueId
Esta propiedad contiene el ID único de este punto o token, si existe.
A menudo no es válido (véase isValid()), porque las pantallas táctiles no pueden identificar de forma única los dedos.
Cuando proviene de un QTabletEvent, identifica el número de serie del lápiz óptico en uso.
Puede identificar un token específico (objeto fiducial) cuando el controlador TUIO está en uso con una pantalla táctil que los soporta.
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 escritorio.
Nota: Si las capacidades del dispositivo incluyen QInputDevice::Velocity, significa que la velocidad proviene del sistema operativo (quizás el hardware táctil o el controlador la proporcionan). Pero normalmente la capacidad Velocity no está establecida, indicando que la velocidad es calculada por Qt, usando un simple filtro Kalman para proporcionar una velocidad media suavizada en lugar de un valor instantáneo. Efectivamente, indica cómo de rápido y en qué dirección ha arrastrado el usuario este punto en los últimos eventos, siendo el evento más reciente el que más influye.
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)
Construye un punto de evento con los datos pointId, state, scenePosition y globalPosition.
[noexcept] QEventPoint::QEventPoint(const QEventPoint &other)
Construye un punto de evento haciendo una copia superficial de other.
[constexpr noexcept] QEventPoint::QEventPoint(QEventPoint &&other)
Construye un punto de evento moviendo other.
[noexcept] QEventPoint::~QEventPoint()
Destruye 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)
Mover-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 este 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.
