MouseArea QML Type

Diese Eigenschaften enthalten die Koordinaten des Mauszeigers.

Wenn die Eigenschaft hoverEnabled false ist, sind diese Eigenschaften nur gültig, solange eine Taste gedrückt ist, und bleiben gültig, solange die Taste gedrückt gehalten wird, auch wenn die Maus außerhalb des Bereichs bewegt wird.

Standardmäßig ist diese Eigenschaft falsch.

Wenn hoverEnabled wahr ist, sind diese Eigenschaften gültig, wenn:

• keine Taste gedrückt wird, aber die Maus sich innerhalb des MouseArea befindet (containsMouse ist true).
• eine Taste gedrückt und gehalten wird, auch wenn sie sich inzwischen aus dem Bereich entfernt hat.

Die Koordinaten sind relativ zu MouseArea.

Diese Eigenschaft enthält die Maustasten, auf die der Mausbereich reagiert.

Um festzulegen, dass MouseArea auf mehrere Tasten reagiert, werden die Werte der Qt::MouseButtons Flagge mit dem Operator "|" (oder) kombiniert:

MouseArea { acceptedButtons: Qt.LeftButton | Qt.RightButton }

Um anzugeben, dass alle möglichen Maustasten akzeptiert werden sollen, kann der spezielle Wert "Qt.AllButtons" verwendet werden:

MouseArea { acceptedButtons: Qt.AllButtons }

Der Standardwert ist Qt.LeftButton.

Diese Eigenschaft gibt an, ob sich die Maus gerade im Mausbereich befindet.

Dies ist eine Komfort-Eigenschaft, die pressed && containsMouse entspricht, d.h. sie gibt an, ob acceptedButtons gerade gedrückt wird und sich der Mauszeiger gerade innerhalb von MouseArea befindet.

Diese Eigenschaft ist besonders nützlich, um ein Element hervorzuheben, während die Maus innerhalb seiner Grenzen gedrückt wird.

Siehe auch pressed und containsMouse.

Diese Eigenschaft enthält die Cursorform für diesen Mausbereich. Beachten Sie, dass dies auf Plattformen, die keinen Mauszeiger anzeigen, möglicherweise keine Wirkung hat.

Die verfügbaren Cursorformen sind:

• Qt.ArrowCursor
• Qt.UpArrowCursor
• Qt.CrossCursor
• Qt.WaitCursor
• Qt.IBeamCursor
• Qt.SizeVerCursor
• Qt.SizeHorCursor
• Qt.SizeBDiagCursor
• Qt.SizeFDiagCursor
• Qt.SizeAllCursor
• Qt.BlankCursor
• Qt.SplitVCursor
• Qt.SplitHCursor
• Qt.PointingHandCursor
• Qt.ForbiddenCursor
• Qt.WhatsThisCursor
• Qt.BusyCursor
• Qt.OpenHandCursor
• Qt.ClosedHandCursor
• Qt.DragCopyCursor
• Qt.DragMoveCursor
• Qt.DragLinkCursor

Um nur eine Mauscursorform für eine Region zu setzen, ohne auf Mausereignisse zu reagieren, setzen Sie acceptedButtons auf none:

MouseArea { cursorShape: Qt.IBeamCursor; acceptedButtons: Qt.NoButton }

Der Standardwert ist Qt.ArrowCursor.

Siehe auch Qt::CursorShape.

drag bietet eine bequeme Möglichkeit, ein Element verschiebbar zu machen.

• drag.target gibt die ID des zu ziehenden Objekts an.
• drag.active gibt an, ob das Zielelement gerade gezogen wird.
• drag.axis gibt an, ob das Ziehen horizontal (Drag.XAxis), vertikal (Drag.YAxis), oder beides (Drag.XAndYAxis) erfolgen kann
• drag.minimum und drag.maximum begrenzen, wie weit das Ziel entlang der entsprechenden Achsen gezogen werden kann.

Im folgenden Beispiel wird ein Rectangle angezeigt, das entlang der X-Achse gezogen werden kann. Die Deckkraft des Rechtecks wird verringert, wenn es nach rechts gezogen wird.

Rectangle {
    id: container
    width: 600; height: 200

    Rectangle {
        id: rect
        width: 50; height: 50
        color: "red"
        opacity: (600.0 - rect.x) / 600

        MouseArea {
            anchors.fill: parent
            drag.target: rect
            drag.axis: Drag.XAxis
            drag.minimumX: 0
            drag.maximumX: container.width - rect.width
        }
    }
}

Wenn drag.filterChildren auf true gesetzt ist, kann ein Ziehen absteigende MouseAreas außer Kraft setzen. Auf diese Weise kann ein übergeordneter MouseArea z. B. Ziehen behandeln, während die Nachkommen Klicks behandeln:

import QtQuick

Rectangle {
    width: 480
    height: 320
    Rectangle {
        x: 30; y: 30
        width: 300; height: 240
        color: "lightsteelblue"

        MouseArea {
            anchors.fill: parent
            drag.target: parent;
            drag.axis: "XAxis"
            drag.minimumX: 30
            drag.maximumX: 150
            drag.filterChildren: true

            Rectangle {
                color: "yellow"
                x: 50; y : 50
                width: 100; height: 100
                MouseArea {
                    anchors.fill: parent
                    onClicked: console.log("Clicked")
                }
            }
        }
    }
}

drag.threshold bestimmt den Schwellenwert in Pixeln, ab dem der Ziehvorgang beginnen soll. Standardmäßig ist dies an einen plattformabhängigen Wert gebunden. Diese Eigenschaft wurde in Qt Quick 2.2 hinzugefügt.

Wenn drag.smoothed auf true gesetzt ist, wird das Ziel erst verschoben, nachdem der Ziehvorgang begonnen hat. Wenn sie auf false gesetzt ist, wird das Ziel direkt an die aktuelle Mausposition verschoben. Standardmäßig ist diese Eigenschaft auf true eingestellt. Diese Eigenschaft wurde in Qt Quick 2.4 hinzugefügt.

Sehen Sie sich die angehängte Eigenschaft Drag und DropArea an, wenn Sie einen Drop durchführen möchten.

Diese Eigenschaft gibt an, ob das Element Mausereignisse akzeptiert.

Standardmäßig ist diese Eigenschaft true.

Diese Eigenschaft legt fest, ob Hover-Ereignisse behandelt werden.

Standardmäßig werden Mausereignisse nur als Reaktion auf ein Schaltflächenereignis oder beim Drücken einer Schaltfläche behandelt. Hover ermöglicht die Behandlung aller Mausereignisse, auch wenn keine Maustaste gedrückt wird.

Diese Eigenschaft wirkt sich auf die Eigenschaft containsMouse und die Signale onEntered, onExited und onPositionChanged aus.

Diese Eigenschaft setzt die verstrichene Zeit in Millisekunden außer Kraft, bevor pressAndHold ausgegeben wird.

Wenn sie nicht explizit gesetzt wird - oder nach dem Zurücksetzen - folgt der Wert QStyleHints::mousePressAndHoldInterval.

Normalerweise reicht es aus, diese Eigenschaft global über den Anwendungsstil-Hinweis zu setzen. Diese Eigenschaft sollte verwendet werden, wenn unterschiedliche Intervalle für bestimmte MouseAreas benötigt werden.

Siehe auch pressAndHold.

Diese Eigenschaft gibt an, ob eine der acceptedButtons aktuell gedrückt ist.

Diese Eigenschaft enthält die aktuell gedrückten Maustasten.

Sie enthält eine bitweise Kombination von:

• Qt.LeftButton
• Qt.RightButton
• Qt.MiddleButton

Der folgende Code zeigt "rechts" an, wenn die rechte Maustaste gedrückt ist:

Text {
    text: mouseArea.pressedButtons & Qt.RightButton ? "right" : ""
    horizontalAlignment: Text.AlignHCenter
    verticalAlignment: Text.AlignVCenter

    MouseArea {
        id: mouseArea
        anchors.fill: parent
        acceptedButtons: Qt.LeftButton | Qt.RightButton
    }
}

Siehe auch acceptedButtons.

Diese Eigenschaft legt fest, ob die Mausereignisse von dieser MouseArea gestohlen werden dürfen.

Wenn ein MouseArea innerhalb eines Elements platziert wird, das untergeordnete Mausereignisse filtert, wie z. B. Flickable, können die Mausereignisse von MouseArea gestohlen werden, wenn eine Geste vom übergeordneten Element erkannt wird, z. B. eine Flick-Geste. Wenn preventStealing auf true gesetzt ist, wird kein Element die Mausereignisse stehlen.

Beachten Sie, dass das Setzen von preventStealing auf true, sobald ein Element mit dem Stehlen von Ereignissen begonnen hat, bis zum nächsten Druckereignis keine Wirkung mehr hat.

Standardmäßig ist diese Eigenschaft auf false gesetzt.

Diese Eigenschaft legt fest, ob zusammengesetzte Mausereignisse automatisch auf andere MouseAreas übertragen werden, die sich mit diesem MouseArea überschneiden, aber in der visuellen Stapelreihenfolge niedriger sind. Standardmäßig ist diese Eigenschaft false.

MouseArea enthält mehrere zusammengesetzte Ereignisse: clicked, doubleClicked und pressAndHold. Diese sind aus grundlegenden Mausereignissen zusammengesetzt, wie pressed, und können im Vergleich zu grundlegenden Ereignissen anders propagiert werden.

Wenn propagateComposedEvents auf true gesetzt ist, werden zusammengesetzte Ereignisse automatisch an andere MouseAreas an der gleichen Stelle in der Szene weitergegeben. Jedes Ereignis wird an die nächste enabled MouseArea unter ihm in der Stapelreihenfolge weitergegeben, und zwar so lange, bis ein MouseArea das Ereignis annimmt. Im Gegensatz zu pressed Ereignissen werden zusammengesetzte Ereignisse nicht automatisch akzeptiert, wenn kein Handler vorhanden ist.

Das folgende Beispiel zeigt ein gelbes Rectangle, das ein blaues Rectangle enthält. Das blaue Rechteck ist das oberste Element in der Hierarchie der visuellen Stapelreihenfolge; es wird visuell über dem gelben Rechteck gerendert. Da das blaue Rechteck propagateComposedEvents auf true setzt und auch MouseEvent::accepted für alle empfangenen clicked -Ereignisse auf false setzt, werden alle clicked -Ereignisse, die es empfängt, an das MouseArea des gelben Rechtecks unter ihm weitergegeben.

import QtQuick 2.0

Rectangle {
    color: "yellow"
    width: 100; height: 100

    MouseArea {
        anchors.fill: parent
        onClicked: console.log("clicked yellow")
    }

    Rectangle {
        color: "blue"
        width: 50; height: 50

        MouseArea {
            anchors.fill: parent
            propagateComposedEvents: true
            onClicked: (mouse)=> {
                console.log("clicked blue")
                mouse.accepted = false
            }
        }
    }
}

Wenn Sie auf das blaue Rechteck klicken, wird der onClicked Handler des untergeordneten MouseArea aufgerufen; das Ereignis wird dann an das MouseArea des gelben Rechtecks weitergegeben, wodurch dessen eigener onClicked Handler aufgerufen wird.

Diese Eigenschaft vereinfacht den Anwendungsfall erheblich, wenn Sie überlappende MouseAreas haben möchten, die die zusammengesetzten Ereignisse gemeinsam behandeln. Zum Beispiel: wenn Sie möchten, dass ein MouseArea die Signale von clicked und das andere die von pressAndHold behandelt, oder wenn Sie möchten, dass ein MouseArea die meiste Zeit clicked behandelt, es aber weiterleitet, wenn bestimmte Bedingungen erfüllt sind.

Diese Eigenschaft steuert, ob MouseArea auf Bildlaufgesten von Nicht-Maus-Geräten reagiert, wie z. B. die 2-Finger-Schnipp-Geste auf einem Trackpad. Wenn sie auf false gesetzt ist, wird das Signal wheel nur ausgegeben, wenn das Rad-Ereignis von einer Maus mit einem Rad kommt, während Bildlaufgesten-Ereignisse an jedes andere Element weitergegeben werden, das sie verarbeiten kann. Beispielsweise könnte der Benutzer eine Flick-Geste ausführen, während sich der Cursor über einem Element befindet, das ein MouseArea enthält, um mit einem Flickable zu interagieren, das sich darunter befindet. Wenn diese Eigenschaft auf false gesetzt wird, kann PinchArea das Mausrad oder die Pinch-Geste verarbeiten, während das Flickable die Flick-Geste verarbeitet.

Standardmäßig ist diese Eigenschaft auf true gesetzt.

Dieses Signal wird ausgegeben, wenn Mausereignisse abgebrochen wurden, weil ein anderes Element die Behandlung von Mausereignissen übernommen hat.

Dieses Signal ist für den fortgeschrittenen Gebrauch gedacht: Es ist nützlich, wenn es mehr als ein MouseArea gibt, das Eingaben verarbeitet, oder wenn es ein MouseArea innerhalb eines Flickable gibt. Im letzteren Fall, wenn Sie eine Logik im onPressed Signalhandler ausführen und dann mit dem Ziehen beginnen, wird das Flickable die Mausbehandlung vom MouseArea stehlen. In diesen Fällen, um die Logik zurückzusetzen, wenn das MouseArea die Mausbehandlung an das Flickable verloren hat, sollte canceled zusätzlich zu released behandelt werden.

Dieses Signal wird ausgegeben, wenn es einen Klick gibt. Ein Klick ist definiert als ein Drücken, gefolgt von einem Loslassen, beides innerhalb des MouseArea (Drücken, Bewegen außerhalb des MouseArea, und dann wieder hineinbewegen und loslassen wird ebenfalls als Klick betrachtet).

Der Parameter mouse liefert Informationen über den Klick, einschließlich der x- und y-Position des Loslassens des Klicks, und ob der Klick gehalten wurde.

Bei der Verarbeitung dieses Signals hat die Änderung der Eigenschaft accepted des Parameters mouse keine Auswirkungen, es sei denn, die Eigenschaft propagateComposedEvents lautet true.

Dieses Signal wird bei einem Doppelklick (Drücken, gefolgt von Loslassen und erneutem Drücken) ausgegeben. Der Parameter mouse liefert Informationen über den Klick, einschließlich der x- und y-Position des Loslassens des Klicks, und ob der Klick gehalten wurde.

Wenn bei der Verarbeitung dieses Signals die Eigenschaft accepted des Parameters mouse auf false gesetzt ist, werden die Signale pressed/released/clicked für den zweiten Klick ausgegeben; andernfalls werden sie unterdrückt. Die Eigenschaft accepted ist standardmäßig auf true gesetzt.

Dieses Signal wird ausgegeben, wenn die Maus den Mausbereich betritt.

Standardmäßig wird dieses Signal nur ausgegeben, wenn gerade eine Schaltfläche gedrückt ist. Setzen Sie hoverEnabled auf true, um dieses Signal auch dann zu senden, wenn keine Maustaste gedrückt ist.

Siehe auch hoverEnabled.

Dieses Signal wird ausgegeben, wenn die Maus den Mausbereich verlässt.

Standardmäßig wird dieses Signal nur ausgegeben, wenn gerade eine Taste gedrückt ist. Setzen Sie hoverEnabled auf true, um dieses Signal auch dann auszusenden, wenn keine Maustaste gedrückt ist.

Das folgende Beispiel zeigt eine typische Beziehung zwischen zwei MouseAreas, wobei mouseArea2 über mouseArea1 liegt. Wenn Sie die Maus von mouseArea1 auf mouseArea2 bewegen, wird mouseArea1 das Signal exited ausgeben.

Rectangle {
    width: 400; height: 400
    MouseArea {
        id: mouseArea1
        anchors.fill: parent
        hoverEnabled: true
    }
    MouseArea {
        id: mouseArea2
        width: 100; height: 100
        anchors.centerIn: parent
        hoverEnabled: true
    }
}

Wenn Sie stattdessen den beiden MouseAreas eine Eltern-Kind-Beziehung geben, wird das Bewegen der Maus in mouseArea2 von mouseArea1 aus nicht dazu führen, dass mouseArea1 das Signal exited ausgibt. Stattdessen wird davon ausgegangen, dass beide gleichzeitig mit der Maus berührt werden.

Siehe auch hoverEnabled.

Dieses Signal wird ausgesendet, wenn sich die Mausposition ändert.

Der Parameter mouse liefert Informationen über die Maus, einschließlich der x- und y-Position und aller aktuell gedrückten Tasten.

Standardmäßig wird dieses Signal nur ausgegeben, wenn eine Taste gedrückt ist. Setzen Sie hoverEnabled auf true, um dieses Signal auch dann auszusenden, wenn keine Maustaste gedrückt ist.

Bei der Behandlung dieses Signals hat die Änderung der Eigenschaft accepted des Parameters mouse keine Auswirkungen.

Dieses Signal wird ausgegeben, wenn die Maustaste lange gedrückt wird (derzeit 800 ms). Der Parameter mouse liefert Informationen über den Druck, einschließlich der x- und y-Position des Drucks und der gedrückten Taste.

Bei der Verarbeitung dieses Signals hat die Änderung der Eigenschaft accepted des Parameters mouse keine Auswirkungen, es sei denn, die Eigenschaft propagateComposedEvents lautet true.

Dieses Signal wird ausgegeben, wenn eine Taste gedrückt wird. Der Parameter mouse liefert Informationen über den Druck, einschließlich der x- und y-Position und der gedrückten Taste.

Wenn Sie dieses Signal behandeln, verwenden Sie die accepted Eigenschaft des mouse Parameters, um zu steuern, ob MouseArea das Drücken und alle zukünftigen Mausereignisse bis zum Loslassen behandelt. Standardmäßig wird das Ereignis akzeptiert und andere MouseAreas unterhalb dieses Bereichs dürfen das Ereignis nicht behandeln. Wenn accepted auf false gesetzt ist, werden keine weiteren Ereignisse an dieses MouseArea gesendet, bis die Taste das nächste Mal gedrückt wird.

Dieses Signal wird ausgesendet, wenn eine Freigabe erfolgt. Der Parameter mouse liefert Informationen über den Klick, einschließlich der x- und y-Position der Freigabe des Klicks, und ob der Klick gehalten wurde.

Bei der Behandlung dieses Signals hat die Änderung der Eigenschaft accepted des Parameters mouse keine Auswirkungen.

Siehe auch canceled.

Dieses Signal wird als Reaktion auf Mausrad- und Trackpad-Bildlaufgesten ausgegeben.

Der Parameter wheel liefert Informationen über das Ereignis, einschließlich der x- und y-Position, aller aktuell gedrückten Tasten und Informationen über die Radbewegung, einschließlich angleDelta und pixelDelta.