Qt Quick Beispiele - MouseArea

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

DasMouseArea-Beispiel zeigt, wie man auf Klicks und Ziehen mit einem MouseArea reagiert. Weitere Informationen finden Sie unter Wichtige Konzepte in Qt Quick - Benutzereingabe.

Ausführen des Beispiels

Zum Ausführen des Beispiels von Qt Creatorzu starten, öffnen Sie den Modus Welcome und wählen Sie das Beispiel unter Examples aus. Weitere Informationen finden Sie unter Erstellen und Ausführen eines Beispiels.

MouseArea-Verhalten

Wenn Sie in das rote Quadrat klicken, listet der Typ Text mehrere Eigenschaften dieses Klicks auf, die QML zur Verfügung stehen. Die Deckkraft des roten Quadrats wird reduziert, während die Maus gedrückt wird und innerhalb des MouseArea verbleibt.

Signale werden von MouseArea ausgegeben, wenn Klicks oder andere diskrete Operationen innerhalb des Quadrats 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 verwendet werden, um Elemente zu verschieben. Durch Setzen der Parameter der Eigenschaft drag wird das Zielobjekt herumgezogen, wenn der Benutzer beginnt, innerhalb der Mausbereichsgrenze zu ziehen.

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

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