Obsolete Members for MouseEvent

Los siguientes miembros del tipo MouseEvent de QML están obsoletos. Se mantienen para que el código fuente antiguo siga funcionando. Recomendamos encarecidamente no utilizarlos en código nuevo.

Propiedades

  • source : int (deprecated in 6.2)

Documentación inmobiliaria

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

Esta propiedad ha quedado obsoleta desde QtQuick 6.2. Recomendamos encarecidamente no utilizarla en código nuevo.

Utiliza controladores de entrada con la propiedad ` acceptedDevices ` establecida.

Esta propiedad contiene el origen del evento de ratón.

La fuente del evento del ratón se puede utilizar para distinguir entre eventos del ratón auténticos 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 la tableta reales, los eventos del ratón pueden ser sintetizados por el sistema operativo o por el propio Qt.

El valor puede ser uno de los siguientes:

  • Qt.MouseEventNotSynthesized - El valor más común. En plataformas donde se dispone de dicha información, este valor indica que el evento representa un evento de ratón auténtico del sistema.
  • Qt.MouseEventSynthesizedBySystem - Indica que el evento del 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 por Qt a partir de un evento táctil o de tableta no gestionado.
  • Qt.MouseEventSynthesizedByApplication - Indica que el evento de ratón fue sintetizado por la aplicación. Esto permite distinguir los eventos de ratón generados por la aplicación de los que proceden del sistema o son sintetizados por Qt.

Por ejemplo, para reaccionar únicamente 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 controlador del evento de pulsación rechaza el evento, este se propagará más allá, y entonces otro `Item` subyacente podrá gestionar los eventos sintetizados procedentes de pantallas táctiles. Por ejemplo, si se utiliza un `Flickable` en un nivel inferior (y el ` MouseArea ` no es un elemento hijo del `Flickable`), puede resultar útil que el ` MouseArea ` gestione los eventos de ratón auténticos de una forma, al tiempo que permite que los eventos táctiles se transmitan al `Flickable` subyacente, de modo que se mantenga la capacidad de deslizar el dedo en una pantalla táctil. En ese caso, se perdería la posibilidad de arrastrar el «Flickable» con el ratón, pero esto no impide que el «Flickable» reciba eventos de la rueda del ratón.


© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.