WheelEvent QML Type

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

• Liste de tous les membres, y compris les membres hérités

Propriétés

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

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

accepted : bool

Le fait de régler accepted sur true empêche la propagation de l'événement 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 "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é indiquent 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 :

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

Voir aussi QWheelEvent::buttons().

inverted : bool [read-only]

Indique si les valeurs delta fournies 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.

Voir également QWheelEvent::inverted().

modifiers : int [read-only]

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

Elle contient une combinaison bit à bit de :

• Qt.NoModifier - Aucune touche de modification n'est enfoncée.
• Qt.ShiftModifier - Une touche Shift du clavier est enfoncée.
• Qt.ControlModifier - Une touche Ctrl du clavier est enfoncée.
• Qt.AltModifier - Une touche Alt du clavier est enfoncée.
• Qt.MetaModifier - Une touche Meta du clavier est enfoncée.
• Qt.KeypadModifier - Une touche du clavier est enfoncée.

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 aussi 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, comme macOS. Les coordonnées x et y de cette propriété indiquent le delta en 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().

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

Voir également QWheelEvent::position().