Obsolete Members for MouseEvent

Los siguientes miembros del tipo QML MouseEvent están obsoletos. Se proporcionan para que el código fuente antiguo siga funcionando. Desaconsejamos su uso en código nuevo.

Propiedades

• source : int (deprecated in 6.2)

Documentación de la propiedad

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

Esta propiedad está obsoleta desde QtQuick 6.2. Desaconsejamos su uso en código nuevo.

Use manejadores de entrada con acceptedDevices set.

Esta propiedad contiene la fuente del evento de ratón.

La fuente del evento de ratón puede usarse para distinguir entre eventos de ratón genuinos y artificiales. Cuando se utilizan otros dispositivos señaladores como pantallas táctiles y tabletas gráficas, si la aplicación no hace uso de los eventos táctiles o de tableta reales, los eventos de ratón pueden ser sintetizados por el sistema operativo o por el propio Qt.

El valor puede ser uno de:

• Qt.MouseEventNotSynthesized - El valor más común. En plataformas donde dicha información está disponible, este valor indica que el evento representa un evento de ratón genuino del sistema.
• Qt.MouseEventSynthesizedBySystem - Indica que el evento de ratón fue sintetizado a partir de un evento táctil o de tableta por la plataforma.
• Qt.MouseEventSynthesizedByQt - Indica que el evento de ratón fue sintetizado a partir de un evento de toque o tableta no manejado por Qt.
• Qt.MouseEventSynthesizedByApplication - Indica que el evento del ratón fue sintetizado por la aplicación. Esto permite distinguir los eventos de ratón generados por la aplicación de los que provienen del sistema o son sintetizados por Qt.

Por ejemplo, para reaccionar sólo a los eventos que provienen de un ratón real:

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

    onClicked: doSomething()
}

Si el manejador del evento de pulsación rechaza el evento, se propagará más allá, y entonces otro Item debajo puede manejar eventos sintetizados de pantallas táctiles. Por ejemplo, si se utiliza un Flickable debajo (y el MouseArea no es un hijo del Flickable), puede ser útil para el MouseArea manejar eventos de ratón genuinos de una manera, mientras que permite que los eventos táctiles caigan a través del Flickable debajo, de modo que se mantenga la capacidad de deslizar en una pantalla táctil. En ese caso se perdería la capacidad de arrastrar el Flickable a través del ratón, pero no impide que el Flickable reciba eventos de la rueda del ratón.