Obsolete Members for MouseEvent

Les membres suivants du type QML MouseEvent sont obsolètes. Ils sont fournis pour permettre aux anciens codes sources de continuer à fonctionner. Il est fortement déconseillé de les utiliser dans un nouveau code.

Propriétés

• source : int (deprecated in 6.2)

Documentation sur les biens

source : int [read-only, deprecated in 6.2]

Cette propriété est obsolète depuis QtQuick 6.2. Il est fortement déconseillé de l'utiliser dans un nouveau code.

Utilisez les gestionnaires d'entrée avec acceptedDevices.

Cette propriété contient la source de l'événement souris.

La source de l'événement souris peut être utilisée pour distinguer les événements souris authentiques des événements souris artificiels. Lors de l'utilisation d'autres dispositifs de pointage tels que les écrans tactiles et les tablettes graphiques, si l'application n'utilise pas les événements tactiles ou de la tablette, les événements de la souris peuvent être synthétisés par le système d'exploitation ou par Qt lui-même.

La valeur peut être l'une des suivantes :

• Qt.MouseEventNotSynthesized - La valeur la plus courante. Sur les plateformes où cette information est disponible, cette valeur indique que l'événement représente un véritable événement souris du système.
• Qt.MouseEventSynthesizedBySystem - Indique que l'événement souris a été synthétisé à partir d'un événement tactile ou tablette par la plateforme.
• Qt.MouseEventSynthesizedByQt - Indique que l'événement souris a été synthétisé à partir d'un événement tactile ou tablette non géré par Qt.
• Qt.MouseEventSynthesizedByApplication - Indique que l'événement souris a été synthétisé par l'application. Cela permet de distinguer les événements souris générés par l'application de ceux qui proviennent du système ou qui sont synthétisés par Qt.

Par exemple, pour ne réagir qu'aux événements provenant d'une souris réelle :

MouseArea {
    onPressed: (mouse)=> {
        if (mouse.source !== Qt.MouseEventNotSynthesized)
            mouse.accepted = false
    }

    onClicked: doSomething()
}

Si le gestionnaire de l'événement "press" rejette l'événement, celui-ci sera propagé plus loin, puis un autre élément situé en dessous pourra gérer les événements synthétisés provenant d'écrans tactiles. Par exemple, si un Flickable est utilisé en dessous (et que le site MouseArea n'est pas un enfant du Flickable), il peut être utile que le site MouseArea traite les événements de souris authentiques d'une certaine manière, tout en permettant aux événements tactiles de tomber sur le Flickable situé en dessous, de sorte que la possibilité de cliquer sur un écran tactile soit conservée. Dans ce cas, la possibilité de faire glisser le Flickable à l'aide de la souris serait perdue, mais cela n'empêche pas le Flickable de recevoir des événements liés à la molette de la souris.