WheelEvent QML Type (Uncreatable)

Fournit des informations sur un événement lié à la molette de la souris. En savoir plus...

Remarque : il s'agit d'un type non instanciable. Il ne peut pas être instancié dans QML.

• 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 déterminée à l'aide des propriétés x et y.

Voir également WheelHandler et MouseArea.

Documentation sur les propriétés

accepted : bool

En définissant ` accepted ` sur ` true `, on empêche l'événement de la molette de se propager aux éléments situés en dessous de l'élément récepteur ou du gestionnaire.

En règle générale, si l'élément réagit à l'événement de molette, celui-ci doit être accepté afin que les éléments situés plus bas dans l'ordre de superposition ne réagissent pas également au même événement.

Voir également ` QWheelEvent::accepted`.

angleDelta : point [read-only]

Cette propriété contient l'angle de rotation relatif de la roue, exprimé en huitièmes de degré. Les coordonnées x et y de cette propriété contiennent respectivement le delta des orientations horizontale et verticale.

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

La plupart des souris fonctionnent par incréments de 15 degrés ; dans ce 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 qui étaient enfoncés au moment où l'événement de la molette a été généré.

Elle contient une combinaison binaire des éléments suivants :

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

Voir également QWheelEvent::buttons().

inverted : bool [read-only]

Indique si les valeurs delta transmises avec l'événement sont inversées.

Normalement, une molette verticale produit une WheelEvent avec des valeurs delta positives si le haut de la molette s'éloigne de la main qui l'actionne. De même, un mouvement horizontal de la molette produit une QWheelEvent avec des valeurs delta positives si le haut de la molette est déplacé vers la gauche.

Cependant, sur certaines plateformes, ce comportement est configurable, de sorte que les mêmes opérations décrites ci-dessus produiront des valeurs delta négatives (mais de même amplitude). Par exemple, dans un composant QML (tel qu’un bouton rotatif ou un curseur) où il est pertinent de synchroniser le mouvement ou la rotation d’un élément avec la direction de la molette, indépendamment des paramètres système, le gestionnaire d’événements de la molette peut utiliser la propriété inverted pour décider s’il faut inverser les valeurs de « angleDelta » ou de « pixelDelta ».

Voir également QWheelEvent::inverted().

modifiers : int [read-only]

Cette propriété contient les indicateurs de modificateurs de clavier qui étaient actifs juste avant que l'événement ne se produise.

Elle contient une combinaison binaire des éléments suivants :

• Qt.NoModifier - Aucune touche de modification n'est enfoncée.
• Qt.ShiftModifier - Une touche Maj 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 pavé numérique est enfoncée.

Par exemple, pour réagir à l’enfoncement de la touche Ctrl lors d’un événement de molette :

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 décalage en pixels d'écran et est disponible sur les plateformes prenant en charge l'trackpads haute résolution, telles que macOS. Les coordonnées x et y de cette propriété indiquent respectivement le décalage horizontal et vertical. Ces valeurs peuvent être utilisées directement pour faire défiler le contenu à l'écran.

Sur les plateformes ne prenant pas en charge l'high-resolution trackpad, pixelDelta sera toujours égal à (0,0), et il convient d'utiliser angleDelta à la place.

Voir également QWheelEvent::pixelDelta().

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

Voir également QWheelEvent::position().