handlerPoint QML Type
Un punto de evento. Más...
| Import Statement: | import QtQuick |
Propiedades
- device : PointerDevice
- ellipseDiameters : size
- id : int
- modifiers : enumeration
- position : point
- pressPosition : point
- pressedButtons : enumeration
- pressure : real
- rotation : real
- sceneGrabPosition : point
- scenePosition : point
- scenePressPosition : point
- uniqueId : pointingDeviceUniqueId
- velocity : vector2d
Descripción detallada
Una representación QML, propiedad del gestor, de un ` QEventPoint`.
Es posible establecer enlaces con las propiedades del « point » o « centroid » actual del controlador. Por ejemplo:
import QtQuick
Item {
width: 640
height: 480
DragHandler {
id: handler
target: null
}
Text {
color: handler.active ? "darkgreen" : "black"
text: handler.centroid.position.x.toFixed(1) + "," + handler.centroid.position.y.toFixed(1)
x: handler.centroid.position.x - width / 2
y: handler.centroid.position.y - height
}
}El punto se mantiene actualizado cuando el « DragHandler » responde activamente a un « eventPoint »; pero una vez que se suelta el punto, o cuando el punto actual está siendo gestionado por otro controlador, « position.x » y « position.y » son 0.
Nota: Esto es prácticamente idéntico a eventPoint; sin embargo, un eventPoint es una copia de corta duración de un Q_GADGET de larga duración que se invalida entre gestos y se reutiliza para entregas de eventos posteriores. No es posible establecer enlaces continuos a sus propiedades, y un controlador individual no puede basarse en él fuera del periodo en el que ese punto forma parte de un gesto activo que dicho controlador está gestionando. handlerPoint es un objeto de tipo Q_GADGET que pertenece al controlador. Esto permite establecer enlaces de duración indefinida a sus propiedades.
Véase también SinglePointHandler::point y MultiPointHandler::centroid.
Documentación de propiedades
device : PointerDevice [read-only]
Esta propiedad contiene el dispositivo del que procede el punto (y su evento).
ellipseDiameters : size [read-only]
Esta propiedad contiene los diámetros de la zona de contacto, siempre que el evento proceda de un punto de contacto y el dispositivo facilite esta información.
Un punto de contacto se representa como un área elíptica en la que el dedo ejerce presión sobre la pantalla táctil. (De hecho, también podría representarse como un mapa de bits; pero, en ese caso, esperamos que se ajuste una estimación elíptica de los límites a la zona de contacto antes de que se envíe el evento). Cuanto más fuerte presione el usuario, mayor será la zona de contacto; por lo tanto, estos diámetros ofrecen una forma alternativa de detectar la presión, en caso de que el dispositivo no incluya un sensor de presión independiente. La elipse tiene su centro en scenePosition (position en las coordenadas locales del elemento del PointerHandler). La propiedad « rotation » proporciona la rotación de la elipse, si se conoce. Se espera que, si « rotation » es cero, « height » sea la dimensión mayor (el eje mayor), debido a la posición habitual de la mano, que se extiende hacia arriba o hacia fuera a lo largo de la superficie.
Si se desconoce el área de contacto o el dispositivo no es una pantalla táctil, estos valores serán cero.
Véase también QtQuick::TouchPoint::ellipseDiameters y QEventPoint::ellipseDiameters.
id : int [read-only]
El número de identificación del punto
Durante un gesto táctil, desde el momento en que se pulsa el primer dedo hasta que se suelta el último, cada punto de contacto tendrá un número de identificación único. Del mismo modo, si se produce una entrada procedente de varios dispositivos (por ejemplo, pulsaciones simultáneas del ratón y de la pantalla táctil), todos los « eventPoints » actuales de todos los dispositivos tendrán identificadores únicos.
Nota: Nose debe dar por sentado que los números de identificación empiezan en cero ni que son secuenciales. Esta suposición suele ser errónea debido al funcionamiento de los controladores subyacentes.
Véase también « QEventPoint::id ».
modifiers : enumeration [read-only]
¿Qué teclas modificadoras están pulsadas actualmente?
Esta propiedad contiene los modificadores del teclado que estaban pulsados en el momento en que se produjo el evento.
position : point [read-only]
La posición dentro del elemento parent
Esta es la posición del elemento « eventPoint » con respecto a los límites del elemento « parent ».
pressPosition : point [read-only]
La posición en la que se pulsó dentro del elemento « parent »
Esta es la posición en la que se pulsó este punto, en relación con los límites de parent.
pressedButtons : enumeration [read-only]
¿Qué botones del ratón o del lápiz óptico están pulsados en este momento?
Véase también MouseArea::pressedButtons.
pressure : real [read-only]
Esta propiedad indica la fuerza con la que el usuario presiona el lápiz óptico sobre una tableta gráfica o el dedo sobre una pantalla táctil, en un rango que va desde 0 (sin presión medible) hasta 1.0 (presión máxima que el dispositivo puede medir).
Solo es válida con determinadas tabletas y pantallas táctiles capaces de medir la presión. En caso contrario, el valor será cero.
rotation : real [read-only]
Esta propiedad contiene el ángulo de rotación del lápiz óptico en una tableta gráfica o la zona de contacto de un punto táctil en una pantalla táctil.
Solo es válida con determinados dispositivos de lápiz óptico para tabletas y pantallas táctiles que puedan medir el ángulo de rotación. De lo contrario, será cero.
sceneGrabPosition : point [read-only]
La posición capturada dentro de la escena
Si este punto ha sido agarrado por un «Pointer Handler» o un «Item», significa que ese objeto ha asumido la responsabilidad exclusiva de gestionar el movimiento y la liberación de dicho punto. En ese caso, esta es la posición en la que se produjo el agarre, en el sistema de coordenadas del grafo de escena.
scenePosition : point [read-only]
La posición dentro de la escena
Esta es la posición del eventPoint respecto a los límites de la escena Qt Quick (normalmente, toda la ventana).
scenePressPosition : point [read-only]
La posición en la que se pulsó dentro de la escena
Es la posición en la que se pulsó este punto, en el sistema de coordenadas del grafo de escena.
uniqueId : pointingDeviceUniqueId [read-only]
El identificador único del punto, si lo hay
Normalmente está vacío, ya que las pantallas táctiles no pueden identificar de forma única los dedos.
En algunos tipos de pantallas táctiles, especialmente aquellas que utilizan controladores TUIO, es posible utilizar marcadores físicos reconocibles (objetos fiduciales) además de los dedos. Por lo tanto, si este punto es un punto táctil y se ha establecido «uniqueId», este es el identificador de dicho objeto.
En una tableta gráfica, cada tipo de lápiz u otra herramienta suele tener un identificador único o un número de serie, lo que puede resultar útil para responder de formas diferentes según la herramienta utilizada.
Para interpretar el contenido de este identificador es necesario conocer el hardware y los controladores que se utilizan.
Véase también QTabletEvent::uniqueId y QtQuick::TouchPoint::uniqueId.
velocity : vector2d [read-only]
Un vector que representa la velocidad media y la dirección del movimiento
Se trata de un vector de velocidad que apunta en la dirección del movimiento, expresado en píxeles lógicos por segundo. Tiene componentes x e y, de las cuales al menos una será distinta de cero cuando este punto esté en movimiento. Contiene la velocidad media reciente: a qué velocidad y en qué dirección se ha estado moviendo recientemente el eventPoint.
Véase también « QtQuick::TouchPoint::velocity » y « QEventPoint::velocity ».
© 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.