Auf dieser Seite

XrVirtualMouse QML Type

Bildet 3D-Controller-Eingaben auf Mauseingaben in 2D-Elementen ab. Mehr...

Import Statement: import QtQuick3D.Xr
Since: Qt 6.8
Inherits:

Item

Eigenschaften

Detaillierte Beschreibung

Die XrVirtualMouse bietet eine Möglichkeit zur Interaktion mit 2D-Benutzeroberflächen in der 3D-Szene.

Sie wird typischerweise wie folgt verwendet:

// XrView { id: xrView
// XrController { id: rightController
XrInputAction {
    id: rightTrigger
    hand: XrInputAction.RightHand
    actionId: [XrInputAction.TriggerPressed, XrInputAction.TriggerValue]
}
XrVirtualMouse {
    view: xrView
    source: rightController
    leftMouseButton: rightTrigger.pressed
}

Eigenschaft Dokumentation

enabled : bool

Gibt an, ob die virtuelle Maus aktiviert ist. Wenn true, sendet die virtuelle Maus Mausereignisse an 2D-Objekte in der Szene.

leftMouseButton : bool

Legt den Zustand der linken Maustaste fest.

Wenn sie auf true gesetzt ist, ist die linke Maustaste gedrückt.

middleMouseButton : bool

Legt den Zustand der mittleren Maustaste fest.

Wenn sie auf true gesetzt ist, ist die mittlere Maustaste gedrückt.

rightMouseButton : bool

Legt den Status der rechten Maustaste fest.

Wenn sie auf true gesetzt ist, ist die rechte Maustaste gedrückt.

scrollPixelDelta : real [default: 15]

Legt die Basisdistanz fest, die bei jedem Bildlaufereignis zurückgelegt wird.

Dies ist die Strecke, die bei einer Bildlaufgeschwindigkeit von 1 zurückgelegt wird.

Siehe auch scrollWheelX und scrollWheelY.

scrollTimerInterval : int [default: 30]

Definiert die Zeit in Millisekunden zwischen den an das System gesendeten Bildlaufereignissen.

scrollWheelX : real

Legt die Geschwindigkeit des horizontalen Bildlaufs fest.

Positive Werte scrollen nach rechts und negative Werte nach links. Die Bildlaufgeschwindigkeit nimmt relativ zum Abstand von Null zu.

Siehe auch scrollPixelDelta.

scrollWheelY : real

Legt die vertikale Bildlaufgeschwindigkeit fest.

Positive Werte werden nach oben und negative Werte nach unten gescrollt. Die Bildlaufgeschwindigkeit nimmt relativ zum Abstand von Null zu.

Siehe auch scrollPixelDelta.

source : Node

Der 3D-Knoten, der die virtuelle Maus steuert.

Die Eigenschaft source ist normalerweise auf XrController eingestellt. Mausereignisse werden für die Position erzeugt, an der sich die forward vector des Knotens source mit einem 2D-Element überschneidet.

view : XrView

Die mit der virtuellen Maus verbundene XR-Ansicht. Enthält die Ansicht, in der die virtuelle Maus arbeitet.

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