En esta página

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

enum State { Unknown, Stationary, Pressed, Updated, Released }
flags States

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

Descripción detallada

Documentación sobre los tipos de miembros

enum QEventPoint::State
flags QEventPoint::States

Especifica el estado de este punto de evento.

ConstanteValorDescripción
QEventPoint::UnknownQt::TouchPointUnknownStateEstado desconocido.
QEventPoint::StationaryQt::TouchPointStationaryEl punto de evento no se ha movido.
QEventPoint::PressedQt::TouchPointPressedSe ha pulsado el punto táctil o el botón.
QEventPoint::UpdatedQt::TouchPointMovedEl punto de evento se ha actualizado.
QEventPoint::ReleasedQt::TouchPointReleasedSe 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.