Obsolete Members for MouseEvent

Les membres suivants du type MouseEvent de QML sont obsolètes. Ils sont fournis afin de garantir la compatibilité avec l'ancien code source. Nous déconseillons fortement de les utiliser dans le nouveau code.

Propriétés

• source : int (deprecated in 6.2)

Documentation relative aux biens immobiliers

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

Cette propriété est obsolète depuis QtQuick 6.2. Nous déconseillons fortement de l'utiliser dans du nouveau code.

Utilisez des gestionnaires d'entrée avec l'option « acceptedDevices » activée.

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

La source de l'événement de souris peut être utilisée pour distinguer les événements de souris authentiques des événements artificiels. Lors de l'utilisation d'autres périphériques de pointage tels que les écrans tactiles et les tablettes graphiques, si l'application n'utilise pas les événements tactiles ou de tablette réels, les événements de 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ù ces informations sont disponibles, cette valeur indique que l’événement correspond à un véritable événement de souris provenant du système.
• Qt.MouseEventSynthesizedBySystem - Indique que l’événement de souris a été synthétisé à partir d’un événement tactile ou de tablette par la plateforme.
• Qt.MouseEventSynthesizedByQt - Indique que l’événement de souris a été synthétisé à partir d’un événement tactile ou de tablette non géré par Qt.
• Qt.MouseEventSynthesizedByApplication - Indique que l’événement de souris a été synthétisé par l’application. Cela permet de distinguer les événements de souris générés par l’application de ceux provenant du système ou synthétisés par Qt.

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

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, et un autre « Item » situé en dessous pourra alors gérer les événements synthétisés provenant d’écrans tactiles. Par exemple, si un `Flickable` est utilisé en dessous (et que l’` MouseArea ` n’est pas un enfant du `Flickable`), il peut être utile que l’` MouseArea ` gère les véritables événements de souris d’une certaine manière, tout en laissant les événements tactiles passer vers le `Flickable` situé en dessous, afin de conserver la possibilité d’effectuer un « flick » sur un écran tactile. 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 les événements de la molette de souris.