Auf dieser Seite

XrVirtualMouse QML Type

Ordnet die Eingaben des 3D-Controllers den Mauseingaben in 2D-Elementen zu. Mehr...

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

Item

Status: Technology preview

Dieser Typ befindet sich in der Technologievorschau und kann sich noch ändern.

Eigenschaften

Ausführliche Beschreibung

Die XrVirtualMouse bietet eine Möglichkeit, mit 2D-Benutzeroberflächen in der 3D-Szene zu interagieren.

Sie wird in der Regel 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
}

Dokumentation der Eigenschaften

enabled : bool

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

leftMouseButton : bool

Legt den Status der linken Maustaste fest.

Wenn der Wert „true“ ist, ist die linke Maustaste gedrückt.

middleMouseButton : bool

Legt den Status der mittleren Maustaste fest.

Wenn der Wert auf „true“ gesetzt ist, ist die mittlere Maustaste gedrückt.

rightMouseButton : bool

Legt den Status der rechten Maustaste fest.

Wenn der Wert auf „true“ gesetzt ist, ist die rechte Maustaste gedrückt.

scrollPixelDelta : real [default: 15]

Legt die Grunddistanz fest, um die bei jedem Scrollvorgang gescrollt wird.

Dies ist die Strecke, um die gescrollt wird, wenn die Scrollgeschwindigkeit 1 beträgt.

Siehe auch scrollWheelX und scrollWheelY.

scrollTimerInterval : int [default: 30]

Legt die Zeit in Millisekunden zwischen den an das System gesendeten Scroll-Ereignissen fest.

scrollWheelX : real

Legt die horizontale Bildlaufgeschwindigkeit fest.

Bei positiven Werten erfolgt der Bildlauf nach rechts, bei negativen Werten nach links. Die Bildlaufgeschwindigkeit nimmt mit zunehmender Entfernung vom Nullpunkt zu.

Siehe auch „ scrollPixelDelta “.

scrollWheelY : real

Legt die vertikale Bildlaufgeschwindigkeit fest.

Bei positiven Werten erfolgt ein Bildlauf nach oben, bei negativen Werten ein Bildlauf nach unten. Die Bildlaufgeschwindigkeit nimmt mit zunehmendem Abstand vom Wert Null zu.

Siehe auch „ scrollPixelDelta “.

source : Node

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

Die Eigenschaft „ source “ ist normalerweise auf „ XrController “ gesetzt. Mausereignisse werden für die Position generiert, an der sich die „ forward vector “ des Knotens „ source “ mit einem 2D-Element schneidet.

view : XrView

Die mit der virtuellen Maus verknüpfte XR-Ansicht. Enthält die Ansicht, in der die virtuelle Maus verwendet wird.

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