En esta página

Qt Quick Ejemplos - MouseArea

Este es un ejemplo del tipo « MouseArea » en QML.

Cuadrado rojo «Hacer clic» y cuadrado azul «Arrastrar» con el texto de estado del evento del ratón a continuación

El ejemplode MouseArea muestra cómo responder a clics y arrastres con un ` MouseArea`. Para obtener más información, consulta «Conceptos importantes» en Qt Quick - Entrada del usuario.

Ejecución del ejemplo

Puedes ejecutar el ejemplo desde:

Comportamiento de MouseArea

Al hacer clic dentro del cuadrado rojo, el tipo « Text » mostrará varias propiedades de ese clic que están disponibles para QML. La opacidad del cuadrado rojo se reducirá mientras se mantenga pulsado el botón del ratón y este permanezca dentro del « MouseArea ».

MouseArea emite señales cuando se producen clics u otras operaciones discretas en su interior.

onPressAndHold: btn.text = qsTr('Press and hold')
onClicked: (mouse) => { btn.text = qsTr('Clicked (wasHeld=') + mouse.wasHeld + ')' }
onDoubleClicked: btn.text = qsTr('Double clicked')

MouseArea También se puede utilizar para arrastrar elementos. Al configurar los parámetros de la propiedad «drag», el elemento de destino se arrastrará si el usuario comienza a arrastrar dentro de los límites del área del ratón.

drag.target: blueSquare
drag.axis: Drag.XAndYAxis
drag.minimumX: 0
drag.maximumX: box.width - parent.width
drag.minimumY: 0
drag.maximumY: box.height - parent.width

Proyecto de ejemplo en @code.qt.io

© 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.