이 페이지에서

XrVirtualMouse QML Type

3D 컨트롤러 입력을 2D 항목의 마우스 입력으로 매핑합니다. 더 보기...

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

Item

Status: Technology preview

이 유형은 기술 미리보기 단계에 있으며 변경될 수 있습니다.

속성

상세 설명

XrVirtualMouse는 3D 장면 내에서 2D 사용자 인터페이스와 상호 작용할 수 있는 방법을 제공합니다.

일반적으로 다음과 같이 사용됩니다:

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

속성 설명

enabled : bool

가상 마우스가 활성화되어 있는지 여부를 나타냅니다. true인 경우, 가상 마우스는 씬 내의 2D 오브젝트에 마우스 이벤트를 전송합니다.

leftMouseButton : bool

마우스 왼쪽 버튼의 상태를 설정합니다.

true로 설정되면 마우스 왼쪽 버튼이 눌린 상태가 됩니다.

middleMouseButton : bool

마우스 가운데 버튼의 상태를 설정합니다.

true로 설정되면 마우스 가운데 버튼이 눌린 상태가 됩니다.

rightMouseButton : bool

마우스 오른쪽 버튼의 상태를 설정합니다.

true로 설정되면 마우스 오른쪽 버튼이 눌린 상태가 됩니다.

scrollPixelDelta : real [default: 15]

각 스크롤 이벤트마다 스크롤되는 기본 거리를 정의합니다.

이는 스크롤 속도가 1일 때 스크롤되는 거리입니다.

scrollWheelX 및 scrollWheelY도 참조하십시오 .

scrollTimerInterval : int [default: 30]

시스템으로 전송되는 스크롤 이벤트 간의 시간을 밀리초 단위로 정의합니다.

scrollWheelX : real

가로 스크롤 속도를 설정합니다.

양수 값은 오른쪽으로 스크롤하고, 음수 값은 왼쪽으로 스크롤합니다. 스크롤 속도는 0으로부터의 거리에 비례하여 증가합니다.

scrollPixelDelta도 참조하십시오 .

scrollWheelY : real

수직 스크롤 속도를 설정합니다.

양수 값은 위쪽으로, 음수 값은 아래쪽으로 스크롤합니다. 스크롤 속도는 0으로부터의 거리에 비례하여 증가합니다.

scrollPixelDelta도 참조하십시오 .

source : Node

가상 마우스를 제어하는 3D 노드입니다.

source 속성은 일반적으로 XrController 로 설정됩니다. 마우스 이벤트는 source 노드의 forward vector 가 2D 항목과 교차하는 위치에서 생성됩니다.

view : XrView

가상 마우스와 연결된 XR 뷰입니다. 가상 마우스가 작동하는 뷰를 유지합니다.

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