WheelEvent QML Type

Proporciona información sobre un evento de la rueda del ratón. Más...

• Lista de todos los miembros, incluidos los heredados

Propiedades

• accepted : bool
• angleDelta : point
• buttons : int
• inverted : bool
• modifiers : int
• pixelDelta : point
• x : real
• y : real

Descripción detallada

La posición del ratón se puede encontrar a través de las propiedades x y y.

Véase también WheelHandler y MouseArea.

Documentación de propiedades

accepted : bool

Establecer accepted a true impide que el evento de rueda se propague a los elementos situados por debajo del elemento o manejador receptor.

Generalmente, si el ítem actúa sobre el evento rueda, debe ser aceptado para que los ítems inferiores en el orden de apilamiento no respondan también al mismo evento.

Véase también QWheelEvent::accepted.

angleDelta : point [read-only]

Esta propiedad contiene la cantidad relativa de rotación de la rueda, en octavos de grado. Las coordenadas x y y de esta propiedad contienen el delta en orientaciones horizontal y vertical, respectivamente.

Un valor positivo indica que la rueda se giró hacia arriba/derecha; un valor negativo indica que la rueda se giró hacia abajo/izquierda.

La mayoría de los tipos de ratón funcionan en pasos de 15 grados, en cuyo caso el valor delta es un múltiplo de 120; es decir, 120 units * 1/8 = 15 degrees.

Véase también QWheelEvent::angleDelta().

buttons : int [read-only]

Esta propiedad contiene los botones del ratón pulsados cuando se generó el evento rueda.

Contiene una combinación bit a bit de:

• Qt.LeftButton
• Qt.RightButton
• Qt.MiddleButton

Ver también QWheelEvent::buttons().

inverted : bool [read-only]

Devuelve si los valores delta entregados con el evento están invertidos.

Normalmente, una rueda vertical producirá un WheelEvent con valores delta positivos si la parte superior de la rueda gira alejándose de la mano que la maneja. Del mismo modo, un movimiento horizontal de la rueda producirá un QWheelEvent con valores delta positivos si la parte superior de la rueda se mueve hacia la izquierda.

Sin embargo, en algunas plataformas esto es configurable, de modo que las mismas operaciones descritas anteriormente producirán valores delta negativos (pero con la misma magnitud). Por ejemplo, en un componente QML (como una volteadora o un control deslizante) en el que conviene sincronizar el movimiento o la rotación de un elemento con la dirección de la rueda, independientemente de la configuración del sistema, el controlador de eventos de la rueda puede utilizar la propiedad invertida para decidir si se anulan los valores angleDelta o pixelDelta.

Véase también QWheelEvent::inverted().

modifiers : int [read-only]

Esta propiedad contiene los indicadores de modificador de teclado que existían inmediatamente antes de que se produjera el evento.

Contiene una combinación bit a bit de:

• Qt.NoModifier - No se ha pulsado ninguna tecla modificadora.
• Qt.ShiftModifier - Se pulsa una tecla Shift del teclado.
• Qt.ControlModifier - Se pulsa una tecla Ctrl del teclado.
• Qt.AltModifier - Se pulsa una tecla Alt del teclado.
• Qt.MetaModifier - Se pulsa una tecla Meta del teclado.
• Qt.KeypadModifier - Se pulsa un botón del teclado.

Por ejemplo, para reaccionar a una tecla Control pulsada durante el evento rueda:

WheelHandler {
    onWheel: (wheel)=> {
        if (wheel.modifiers & Qt.ControlModifier) {
            adjustZoom(wheel.angleDelta.y / 120);
        }
    }
}

Véase también QWheelEvent::modifiers().

pixelDelta : point [read-only]

Esta propiedad mantiene el delta en píxeles de pantalla y está disponible en plataformas que tienen alta resolución trackpads, como macOS. Las coordenadas x y y de esta propiedad contienen el delta en orientaciones horizontal y vertical, respectivamente. Los valores pueden utilizarse directamente para desplazar el contenido en pantalla.

Para plataformas sin soporte high-resolution trackpad, pixelDelta siempre será (0,0), y en su lugar debe utilizarse angleDelta.

Véase también QWheelEvent::pixelDelta().

Estas propiedades contienen las coordenadas de la posición proporcionada por el evento rueda.

Véase también QWheelEvent::position().