MouseEvent QML Type (Uncreatable)

Fournit des informations sur un événement de 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
• Membres obsolètes

Propriétés

• accepted : bool
• button : enumeration
• buttons : int
• flags : int
• modifiers : int
• wasHeld : bool
• x : real
• y : real

Description détaillée

La position de la souris peut être obtenue via les propriétés x et y. Le bouton à l'origine de l'événement est accessible via la propriété button.

Voir également MouseArea.

Documentation sur les propriétés

accepted : bool

Définir la propriété ` accepted ` sur `true` empêche la propagation de l'événement de souris aux éléments situés en dessous de cet élément.

En règle générale, si l'élément réagit à l'événement de souris, celui-ci 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.

button : enumeration [read-only]

Cette propriété contient le bouton à l'origine de l'événement. Elle peut prendre l'une des valeurs suivantes :

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

buttons : int [read-only]

Cette propriété contient les boutons de la souris qui étaient enfoncés au moment où l'événement a été généré. Pour les événements de déplacement de la souris, il s'agit de tous les boutons enfoncés. Pour les événements de clic et de double-clic, cela inclut le bouton à l'origine de l'événement. Pour les événements de relâchement de la souris, cela exclut le bouton à l'origine de l'événement.

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

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

flags : int [read-only]

Cette propriété contient les indicateurs qui fournissent des informations supplémentaires sur l'événement de souris.

• Qt.MouseEventCreatedDoubleClick - Indique que Qt a généré un événement de double-clic à partir de cet événement. Cet indicateur est activé dans l'événement provenant d'une pression sur un bouton, et non dans l'événement de double-clic qui en résulte.

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 à une combinaison de la touche Maj + clic gauche de la souris :

MouseArea {
    onClicked: (mouse)=> {
        if ((mouse.button == Qt.LeftButton) && (mouse.modifiers & Qt.ShiftModifier))
            doSomething();
    }
}

wasHeld : bool [read-only]

Cette propriété est vraie si le bouton de la souris est resté enfoncé pendant une durée supérieure au seuil (800 ms).

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