handlerPoint QML Type

Un punto de evento. Más...

• Lista de todos los miembros, incluidos los heredados

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

Representación QML de un QEventPoint.

Es posible establecer vínculos con las propiedades de point o centroid actuales de un manipulador. 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 está respondiendo activamente a un eventPoint; pero después de que el punto se libera, o cuando el punto actual está siendo manejado por un manejador diferente, position.x y position.y son 0.

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 del parche de contacto, si el evento proviene de un punto táctil y el dispositivo proporciona esta información.

Un punto de contacto se modela como un área elíptica donde el dedo se presiona contra la pantalla táctil. (De hecho, también podría modelarse como un mapa de bits; pero en ese caso esperamos que se ajuste una estimación de delimitación elíptica a la zona de contacto antes de enviar el evento). Cuanto más fuerte presione el usuario, mayor será la zona de contacto; por tanto, estos diámetros proporcionan una forma alternativa de detectar la presión, en caso de que el dispositivo no incluya un sensor de presión independiente. La elipse está centrada en scenePosition (position en las coordenadas locales de PointerHandler's Item). 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, hacia arriba o hacia fuera a través de la superficie.

Si se desconoce la zona 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 ID del punto

Durante un gesto táctil, desde el momento en que se pulsa con el primer dedo hasta que se suelta el último, cada punto táctil tendrá un número ID único. Del mismo modo, si se producen entradas desde varios dispositivos (por ejemplo, pulsaciones simultáneas de ratón y táctil), todos los eventPoints actuales de todos los dispositivos tendrán ID únicos.

Véase también QEventPoint::id.

modifiers : enumeration [read-only]

Qué teclas modificadoras están pulsadas actualmente

Esta propiedad contiene los modificadores de teclado que fueron presionados en el momento en que ocurrió el evento.

position : point [read-only]

La posición dentro del elemento parent

Es la posición de eventPoint con respecto a los límites de parent.

pressPosition : point [read-only]

La posición pulsada dentro del elemento parent

Es la posición en la que se ha pulsado 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 ese momento.

Véase también MouseArea::pressedButtons.

pressure : real [read-only]

Esta propiedad indica la fuerza con la que el usuario está presionando el lápiz en una tableta gráfica o el dedo contra una pantalla táctil, en el rango comprendido entre 0 (ninguna presión medible) y 1.0 (presión máxima que puede medir el dispositivo).

Sólo es válido con determinadas tabletas y pantallas táctiles que pueden medir la presión. En caso contrario, 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.

Sólo es válida con determinados dispositivos de lápiz de tableta y pantallas táctiles que puedan medir el ángulo de rotación. En caso contrario, será cero.

sceneGrabPosition : point [read-only]

La posición tomada dentro de la escena

Si este punto ha sido agarrado por un Manejador de Punteros o un Item, significa que ese objeto ha tomado la responsabilidad exclusiva de manejar el movimiento y la liberación si este punto. En ese caso, esta es la posición en la que se ha producido el agarre, en el sistema de coordenadas del gráfico de la escena.

scenePosition : point [read-only]

La posición dentro de la escena

Es la posición de eventPoint con respecto a los límites de la escena Qt Quick (normalmente toda la ventana).

scenePressPosition : point [read-only]

La posición pulsada dentro de la escena

Es la posición en la que se pulsó este punto, en el sistema de coordenadas del gráfico de la escena.

uniqueId : pointingDeviceUniqueId [read-only]

El identificador único del punto, si existe.

Normalmente está vacío, porque las pantallas táctiles no pueden identificar dedos de forma única.

En algunos tipos de pantallas táctiles, especialmente las que utilizan controladores TUIO, es posible utilizar fichas físicas reconocibles (objetos fiduciales) además de los dedos. Así que si este punto es un punto táctil, y se establece uniqueId, es el identificador de dicho objeto.

En una tableta gráfica, cada tipo de stylus u otra herramienta tiene a menudo un ID único o número de serie, que puede ser útil para responder de diferentes maneras a diferentes herramientas.

Interpretar el contenido de este ID requiere conocer el hardware y los controladores en uso.

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, en píxeles lógicos por segundo. Tiene componentes x e y, al menos uno de los cuales será distinto de cero cuando este punto esté en movimiento. Contiene la velocidad media reciente: a qué velocidad y en qué dirección se ha movido eventPoint recientemente.

Véase también QtQuick::TouchPoint::velocity y QEventPoint::velocity.