Sur cette page

Qt Quick Exemples - MouseArea

Voici un exemple du type « MouseArea » dans QML.

Cliquez sur le carré rouge et faites glisser le carré bleu avec la souris ; le texte d'état de l'événement s'affiche ci-dessous

L'exempleMouseArea montre comment réagir aux clics et aux glissements à l'aide d'un MouseArea. Pour plus d'informations, consultez la section « Concepts importants » de la documentation « Qt Quick » - « Entrées utilisateur ».

Exécution de l'exemple

Vous pouvez exécuter l'exemple à partir de :

Comportement de MouseArea

Lorsque vous cliquez à l’intérieur du carré rouge, le type « Text » répertorie plusieurs propriétés de ce clic qui sont disponibles pour QML. L’opacité du carré rouge diminue tant que le bouton de la souris est enfoncé et que le curseur reste à l’intérieur de la zone « MouseArea ».

Des signaux sont émis par l’ MouseArea lorsque des clics ou d’autres opérations discrètes se produisent à l’intérieur de celle-ci.

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

MouseArea Cette propriété peut également être utilisée pour faire glisser des éléments. En définissant les paramètres de la propriété `drag`, l’élément cible sera déplacé si l’utilisateur commence à le faire glisser à l’intérieur des limites de la zone de la souris.

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

Exemple de projet @ 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.