Auf dieser Seite

Qt Quick Beispiele – MouseArea

Dies ist ein Beispiel für den Typ „ MouseArea “ in QML.

Rotes Klicken auf das Quadrat und blaues Ziehen des Quadrats mit dem folgenden Text zum Mausereignis

Das „MouseArea“-Beispiel zeigt, wie man mit einem „ MouseArea “ auf Klicks und Ziehvorgänge reagiert. Weitere Informationen finden Sie unter „Wichtige Konzepte in „ Qt Quick “ – Benutzereingaben“.

Ausführen des Beispiels

Sie können das Beispiel wie folgt ausführen:

Verhalten von „MouseArea“

Wenn Sie in das rote Quadrat klicken, listet der Typ „ Text “ mehrere Eigenschaften dieses Klicks auf, die in QML verfügbar sind. Die Deckkraft des roten Quadrats wird verringert, solange die Maustaste gedrückt ist und sich der Mauszeiger innerhalb des „ MouseArea “ befindet.

MouseArea sendet Signale aus, wenn Klicks oder andere diskrete Vorgänge innerhalb des Bereichs stattfinden.

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

MouseArea kann auch zum Verschieben von Elementen verwendet werden. Durch Festlegen der Parameter der Eigenschaft „drag“ wird das Zielelement verschoben, wenn der Benutzer innerhalb der Begrenzung des Mausbereichs mit dem Ziehen beginnt.

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

Beispielprojekt @ 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.