En esta página

WheelEvent QML Type (Uncreatable)

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

Import Statement: import QtQuick

Nota: Se trata de un tipo no creable. No se puede instanciar en QML.

Propiedades

Descripción detallada

La posición del ratón se puede obtener mediante las propiedades x y y.

Véase también WheelHandler y MouseArea.

Documentación de las propiedades

accepted : bool

Si se establece ` accepted ` en ` true `, se evita que el evento de la rueda se propague a los elementos situados por debajo del elemento receptor o del controlador.

Por lo general, si el elemento reacciona al evento de la rueda, este debe aceptarse para que los elementos situados más abajo en el orden de superposición no respondan también al mismo evento.

Véase también QWheelEvent::accepted.

angleDelta : point [read-only]

Esta propiedad contiene el ángulo relativo en el que se ha girado la rueda, expresado en octavos de grado. Las coordenadas « x » y « y » de esta propiedad contienen la diferencia en las orientaciones horizontal y vertical, respectivamente.

Un valor positivo indica que la rueda se ha girado hacia arriba o hacia la derecha; un valor negativo indica que la rueda se ha girado hacia abajo o hacia la 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 indica qué botones del ratón estaban pulsados cuando se generó el evento de la rueda.

Contiene una combinación bit a bit de:

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

inverted : bool [read-only]

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

Normalmente, una rueda vertical generará 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 generará un QWheelEvent con valores delta positivos si la parte superior de la rueda se desplaza 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 un control giratorio o un control deslizante) en el que resulte conveniente 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 «inverted» para decidir si invierte los valores de « angleDelta » o « pixelDelta ».

Nota: Muchas plataformas no proporcionan este tipo de información. En dichas plataformas, ` inverted ` siempre devuelve ` false`.

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

modifiers : int [read-only]

Esta propiedad contiene los indicadores de modificadores del teclado que existían justo antes de que se produjera el evento.

Contiene una combinación bit a bit de:

Por ejemplo, para reaccionar ante la pulsación de la tecla Control durante el evento de la 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 contiene la diferencia en píxeles de pantalla y está disponible en plataformas que cuentan con una alta resolución trackpads, como macOS. Las coordenadas x y y de esta propiedad contienen la diferencia en las orientaciones horizontal y vertical, respectivamente. Los valores se pueden utilizar directamente para desplazar el contenido en pantalla.

En las plataformas que no admiten la función « high-resolution trackpad », pixelDelta siempre será (0,0), por lo que se debe utilizar angleDelta en su lugar.

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

x : real [read-only]

y : real [read-only]

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

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

© 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.