이 페이지에서

Qt3DInput::QMouseHandler Class

class Qt3DInput::QMouseHandler

QMouseDevice 인스턴스에 연결되었을 때 마우스 이벤트에 대한 알림을 받을 수 있는 기능을 제공합니다. 더 보기...

헤더: #include <Qt3DInput/QMouseHandler>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3dinput)
target_link_libraries(mytarget PRIVATE Qt6::3dinput)
qmake: QT += 3dinput
QML에서: MouseHandler
상속: Qt3DCore::QComponent
상태: 사용 중단됨

이 클래스는 더 이상 사용되지 않습니다. 새로운 코드에서는 이 클래스를 사용하지 않는 것을 강력히 권장합니다.

속성

공개 함수

QMouseHandler(Qt3DCore::QNode *parent = nullptr)
bool containsMouse() const
Qt3DInput::QMouseDevice *sourceDevice() const

공개 슬롯

void setSourceDevice(Qt3DInput::QMouseDevice *mouseDevice)

신호

void clicked(Qt3DInput::QMouseEvent *mouse)
void containsMouseChanged(bool containsMouse)
void doubleClicked(Qt3DInput::QMouseEvent *mouse)
void entered()
void exited()
void positionChanged(Qt3DInput::QMouseEvent *mouse)
void pressAndHold(Qt3DInput::QMouseEvent *mouse)
void pressed(Qt3DInput::QMouseEvent *mouse)
void released(Qt3DInput::QMouseEvent *mouse)
void sourceDeviceChanged(Qt3DInput::QMouseDevice *mouseDevice)
void wheel(Qt3DInput::QWheelEvent *wheel)

상세 설명

참고: QMouseHandler 컴포넌트는 공유해서는 안 되며, 이 조건을 준수하지 않을 경우 정의되지 않은 동작이 발생할 가능성이 높습니다.

QMouseDevice 및 QMouseEvent도 참조하십시오 .

속성 문서

[read-only] containsMouse : bool

QMouseHandler 가 현재 마우스를 포함하고 있는 경우 true 를 반환합니다.

참고: 이맥락에서 '포함한다'는 것은 마우스에서 출발하는 광선이 현재 QMouseHandler 인스턴스 컴포넌트를 집계하는 Qt3DCore::QEntity와 교차하고 있음을 의미합니다.

액세스 함수:

bool containsMouse() const

알림 신호:

void containsMouseChanged(bool containsMouse)

sourceDevice : Qt3DInput::QMouseDevice*

QMouseHandler 인스턴스의 현재 마우스 소스 장치를 보관합니다.

액세스 함수:

Qt3DInput::QMouseDevice *sourceDevice() const
void setSourceDevice(Qt3DInput::QMouseDevice *mouseDevice)

Notifier 신호:

void sourceDeviceChanged(Qt3DInput::QMouseDevice *mouseDevice)

멤버 함수 문서

[explicit] QMouseHandler::QMouseHandler(Qt3DCore::QNode *parent = nullptr)

parent 을 부모로 하는 새로운 QMouseHandler 인스턴스를 생성합니다.

[signal] void QMouseHandler::clicked(Qt3DInput::QMouseEvent *mouse)

이 신호는 마우스 버튼을 클릭했을 때 발생하며, 이벤트 세부 정보는 ` mouse`에 포함되어 있습니다.

[signal] void QMouseHandler::doubleClicked(Qt3DInput::QMouseEvent *mouse)

이 신호는 마우스 버튼을 두 번 클릭했을 때 발생하며, 이벤트 세부 정보는 ` mouse`에 포함되어 있습니다.

[signal] void QMouseHandler::entered()

[signal] void QMouseHandler::exited()

[signal] void QMouseHandler::positionChanged(Qt3DInput::QMouseEvent *mouse)

이 신호는 마우스 위치가 변경될 때 발생하며, 이벤트 세부 정보는 다음 내에 포함되어 있습니다. mouse

[signal] void QMouseHandler::pressAndHold(Qt3DInput::QMouseEvent *mouse)

이 신호는 마우스 버튼을 눌렀다가 계속 누르고 있을 때 발생하며, 이벤트 세부 정보는 다음 내에 포함되어 있습니다. mouse

[signal] void QMouseHandler::pressed(Qt3DInput::QMouseEvent *mouse)

이 신호는 마우스 버튼이 눌렸을 때 발생하며, 이벤트 세부 정보는 다음 안에 포함되어 있습니다. mouse

[signal] void QMouseHandler::released(Qt3DInput::QMouseEvent *mouse)

이 신호는 마우스 버튼을 놓았을 때 발생하며, 이벤트 세부 정보는 다음 안에 포함되어 있습니다. mouse

[slot] void QMouseHandler::setSourceDevice(Qt3DInput::QMouseDevice *mouseDevice)

QMouseHandler 인스턴스의 마우스 장치를 mouseDevice 로 설정합니다.

참고: sourceDevice 속성에 대한세터 함수입니다.

sourceDevice()도 참조하십시오 .

[signal] void QMouseHandler::wheel(Qt3DInput::QWheelEvent *wheel)

이 신호는 마우스 휠을 사용할 때 발생하며, 이벤트 세부 정보는 다음 내에 포함되어 있습니다. wheel

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