Qt Quick Beispiele – MouseArea
Dies ist ein Beispiel für den Typ „ MouseArea “ in QML.

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:
- Qt Creator
Öffnen Sie den „ Welcome “-Modus und wählen Sie das Beispiel unter „ Examples “ aus. Weitere Informationen finden Sie unter „Qt Creator “: Tutorial: Erstellen und Ausführen.
- Qt Extension for Visual Studio Code
Führen Sie den Befehl „ Qt: Open Qt examples “ aus dem Verzeichnis „ Command Palette “ aus und wählen Sie das Beispiel aus der Liste aus. Weitere Informationen finden Sie unter Qt Extension for Visual Studio Code: Tutorial: Erstellen und 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© 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.