WheelEvent QML Type

Fournit des informations sur un événement lié à la roulette de la souris. Plus d'informations...

Import Statement: import QtQuick

Propriétés

Description détaillée

La position de la souris peut être trouvée via les propriétés x et y.

Voir également WheelHandler et MouseArea.

Documentation sur les propriétés

x : real [read-only]

y : real [read-only]

Ces propriétés contiennent les coordonnées de la position fournie par l'événement de la roue.

Voir également QWheelEvent::position().


accepted : bool

La définition de accepted à true empêche la propagation de l'événement de roue aux éléments situés en dessous de l'élément ou du gestionnaire qui le reçoit.

En règle générale, si l'élément agit sur l'événement de roue, il doit être accepté afin que les éléments situés plus bas dans l'ordre d'empilement ne réagissent pas également au même événement.

Voir également QWheelEvent::accepted.


angleDelta : point [read-only]

Cette propriété indique l'ampleur relative de la rotation de la roue, en huitièmes de degré. Les coordonnées x et y de cette propriété représentent le delta dans les orientations horizontale et verticale, respectivement.

Une valeur positive indique que la roue a été tournée vers le haut/la droite ; une valeur négative indique que la roue a été tournée vers le bas/la gauche.

La plupart des types de souris fonctionnent par pas de 15 degrés, auquel cas la valeur delta est un multiple de 120; c'est-à-dire 120 units * 1/8 = 15 degrees.

Voir également QWheelEvent::angleDelta().


buttons : int [read-only]

Cette propriété contient les boutons de la souris enfoncés lorsque l'événement de la roue a été généré.

Elle contient une combinaison bit à bit de :

Voir aussi QWheelEvent::buttons().


inverted : bool [read-only]

Retourne si les valeurs delta livrées avec l'événement sont inversées.

Normalement, une roue verticale produira un WheelEvent avec des valeurs delta positives si le haut de la roue tourne à l'opposé de la main qui l'actionne. De même, un mouvement horizontal de la roue produira un QWheelEvent avec des valeurs delta positives si le haut de la roue est déplacé vers la gauche.

Toutefois, sur certaines plates-formes, il est possible de configurer cette fonction, de sorte que les mêmes opérations décrites ci-dessus produisent des valeurs delta négatives (mais avec la même ampleur). Par exemple, dans un composant QML (tel qu'un culbuteur ou un curseur) où il convient de synchroniser le mouvement ou la rotation d'un élément avec la direction de la roue, quels que soient les paramètres du système, le gestionnaire d'événements de la roue peut utiliser la propriété inversée pour décider s'il convient d'annuler les valeurs angleDelta ou pixelDelta.

Remarque : de nombreuses plateformes ne fournissent aucune information de ce type. Sur ces plates-formes, inverted renvoie toujours false.

Voir également QWheelEvent::inverted().


modifiers : int [read-only]

Cette propriété contient les drapeaux de modification du clavier qui existaient immédiatement avant que l'événement ne se produise.

Elle contient une combinaison bit à bit de :

Par exemple, pour réagir à une touche de contrôle enfoncée pendant l'événement de la roue :

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

Voir également QWheelEvent::modifiers().


pixelDelta : point [read-only]

Cette propriété contient le delta en pixels d'écran et est disponible sur les plates-formes dotées d'une haute résolution trackpads, telles que macOS. Les coordonnées x et y de cette propriété représentent le delta dans les orientations horizontale et verticale, respectivement. Les valeurs peuvent être utilisées directement pour faire défiler le contenu à l'écran.

Pour les plateformes ne prenant pas en charge high-resolution trackpad, pixelDelta sera toujours (0,0), et angleDelta doit être utilisé à la place.

Voir aussi QWheelEvent::pixelDelta().


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