Sur cette page

XrVirtualMouse QML Type

Mappage de l'entrée du contrôleur 3D à l'entrée de la souris dans les éléments 2D. Plus d'informations...

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

Item

Propriétés

Description détaillée

La souris virtuelle XrVirtualMouse permet d'interagir avec des interfaces utilisateur 2D dans une scène 3D.

Elle est généralement utilisée de la manière suivante :

// 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
}

Documentation sur les propriétés

enabled : bool

Indique si la souris virtuelle est activée. Lorsqu'elle est activée, la souris virtuelle envoie des événements de souris aux objets 2D de la scène.

leftMouseButton : bool

Définit l'état du bouton gauche de la souris.

Lorsqu'il vaut true, le bouton gauche de la souris est enfoncé.

middleMouseButton : bool

Définit l'état du bouton du milieu de la souris.

Lorsqu'il vaut true, le bouton du milieu de la souris est enfoncé.

rightMouseButton : bool

Définit l'état du bouton droit de la souris.

Lorsqu'il vaut true, le bouton droit de la souris est enfoncé.

scrollPixelDelta : real [default: 15]

Définit la distance de base parcourue à chaque événement de défilement.

Il s'agit de la distance parcourue lorsque la vitesse de défilement est de 1.

Voir également scrollWheelX et scrollWheelY.

scrollTimerInterval : int [default: 30]

Définit le temps en millisecondes entre les événements de défilement envoyés au système.

scrollWheelX : real

Définit la vitesse de défilement horizontal.

Les valeurs positives font défiler vers la droite et les valeurs négatives vers la gauche. La vitesse de défilement augmente en fonction de la distance par rapport à zéro.

Voir également scrollPixelDelta.

scrollWheelY : real

Définit la vitesse de défilement vertical.

Les valeurs positives défilent vers le haut et les valeurs négatives vers le bas. La vitesse de défilement augmente en fonction de la distance par rapport à zéro.

Voir également scrollPixelDelta.

source : Node

Le nœud 3D contrôlant la souris virtuelle.

La propriété source est normalement définie sur XrController. Des événements souris sont générés à l'endroit où le nœud forward vector du nœud source croise un élément 2D.

view : XrView

Vue XR associée à la souris virtuelle. Détient la vue dans laquelle la souris virtuelle opère.

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