Sur cette page

XrVirtualMouse QML Type

Convertit les commandes de la manette 3D en commandes de souris pour les éléments 2D. En savoir plus...

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

Item

Status: Technology preview

Ce type est en préversion technologique et est susceptible d'être modifié.

Propriétés

Description détaillée

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

Elle s'utilise généralement comme suit :

// 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. Lorsque cette valeur est « true », 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.

Lorsque cette valeur est définie sur « true », le bouton gauche de la souris est enfoncé.

middleMouseButton : bool

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

Lorsque cette valeur est définie sur « true », le bouton central de la souris est enfoncé.

rightMouseButton : bool

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

Lorsque cette valeur est définie sur « 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 égale à 1.

Voir également scrollWheelX et scrollWheelY.

scrollTimerInterval : int [default: 30]

Définit le délai, 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 proportionnellement à la distance par rapport à zéro.

Voir aussi scrollPixelDelta.

scrollWheelY : real

Permet de régler la vitesse de défilement vertical.

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

Voir aussi scrollPixelDelta.

source : Node

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

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

view : XrView

La vue XR associée à la souris virtuelle. Permet de conserver la vue dans laquelle la souris virtuelle fonctionne.

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