Qt Quick Ejemplos - MouseArea
Este es un ejemplo del tipo « MouseArea » en QML.

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:
- Qt Creator
Abre el modo « Welcome » y selecciona el ejemplo en « Examples ». Para obtener más información, consulta «Qt Creator »: Tutorial: Compilar y ejecutar.
- Qt Extension for Visual Studio Code
Ejecute el comando « Qt: Open Qt examples » desde Command Palette y seleccione el ejemplo de la lista. Para obtener más información, consulte Qt Extension for Visual Studio Code: Tutorial: Compilar y ejecutar.
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© 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.