QAbstract3DInputHandler Class
입력 핸들러의 구현을 위한 베이스 클래스입니다. 더 보기...
| Header: | #include <QAbstract3DInputHandler> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS DataVisualization)target_link_libraries(mytarget PRIVATE Qt6::DataVisualization) |
| qmake: | QT += datavisualization |
| 이후: | QtDataVisualization 1.0 |
| QML에서: | AbstractInputHandler3D |
| 상속: | QObject |
| 상속 대상: |
공용 유형
| enum | InputView { InputViewNone, InputViewOnPrimary, InputViewOnSecondary } |
속성
- inputPosition : QPoint
- inputView : InputView
- scene : Q3DScene*
공공 기능
| virtual | ~QAbstract3DInputHandler() |
| QPoint | inputPosition() const |
| QAbstract3DInputHandler::InputView | inputView() const |
| virtual void | mouseDoubleClickEvent(QMouseEvent *event) |
| virtual void | mouseMoveEvent(QMouseEvent *event, const QPoint &mousePos) |
| virtual void | mousePressEvent(QMouseEvent *event, const QPoint &mousePos) |
| virtual void | mouseReleaseEvent(QMouseEvent *event, const QPoint &mousePos) |
| Q3DScene * | scene() const |
| void | setInputPosition(const QPoint &position) |
| void | setInputView(QAbstract3DInputHandler::InputView inputView) |
| void | setScene(Q3DScene *scene) |
| virtual void | touchEvent(QTouchEvent *event) |
| virtual void | wheelEvent(QWheelEvent *event) |
신호
| void | inputViewChanged(QAbstract3DInputHandler::InputView view) |
| void | positionChanged(const QPoint &position) |
| void | sceneChanged(Q3DScene *scene) |
보호된 기능
| QAbstract3DInputHandler(QObject *parent = nullptr) | |
| int | prevDistance() const |
| QPoint | previousInputPos() const |
| void | setPrevDistance(int distance) |
| void | setPreviousInputPos(const QPoint &position) |
상세 설명
QAbstract3DInputHandler는 입력 이벤트를 받아 카메라 및 조명 움직임으로 변환하는 다양한 입력 처리 구현이 서브 클래싱하는 베이스 클래스입니다. 입력 핸들러는 원시 입력 이벤트를 씬의 슬라이싱 및 선택 이벤트로 변환하기도 합니다.
멤버 유형 문서
enum QAbstract3DInputHandler::InputView
마우스 및 터치 기반 입력 핸들러를 위한 미리 정의된 입력 보기.
| Constant | 값 | 설명 |
|---|---|---|
QAbstract3DInputHandler::InputViewNone | 0 | 마우스 또는 터치가 뷰에 없는 경우. |
QAbstract3DInputHandler::InputViewOnPrimary | 1 | 기본 보기 영역에서 받은 마우스 또는 터치 입력입니다. inputView 이 InputViewOnPrimary가 될 때 보조 보기가 표시되면 보조 보기가 닫힙니다. |
QAbstract3DInputHandler::InputViewOnSecondary | 2 | 보조 보기 영역에 마우스 또는 터치 입력이 수신되었습니다. |
속성 문서
inputPosition : QPoint
이 프로퍼티는 처리된 입력 이벤트를 기준으로 마지막 입력 위치를 저장합니다.
함수에 액세스합니다:
| QPoint | inputPosition() const |
| void | setInputPosition(const QPoint &position) |
알림 신호:
| void | positionChanged(const QPoint &position) |
inputView : InputView
이 속성은 처리된 입력 이벤트의 보기를 기반으로 현재 열거된 입력 보기를 보유합니다.
InputView 열거형 값 중 하나입니다.
보기가 변경되면 inputViewChanged 신호가 전송됩니다.
함수에 액세스합니다:
| QAbstract3DInputHandler::InputView | inputView() const |
| void | setInputView(QAbstract3DInputHandler::InputView inputView) |
알림 신호:
| void | inputViewChanged(QAbstract3DInputHandler::InputView view) |
InputView 를참조하세요 .
scene : Q3DScene*
이 프로퍼티에는 이 추상 입력 핸들러가 제어하는 3D 씬이 저장됩니다.
하나의 입력 핸들러가 하나의 씬을 제어할 수 있습니다. 씬을 입력 핸들러로 설정해도 씬의 소유권은 이전되지 않습니다.
함수 액세스
| Q3DScene * | scene() const |
| void | setScene(Q3DScene *scene) |
알림 신호:
| void | sceneChanged(Q3DScene *scene) |
멤버 함수 문서
[explicit protected] QAbstract3DInputHandler::QAbstract3DInputHandler(QObject *parent = nullptr)
베이스 클래스를 생성합니다. 선택 사항으로 parent 매개변수를 지정할 수 있으며 QObject 생성자에 전달됩니다.
[virtual noexcept] QAbstract3DInputHandler::~QAbstract3DInputHandler()
베이스 클래스를 파괴합니다.
[virtual] void QAbstract3DInputHandler::mouseDoubleClickEvent(QMouseEvent *event)
마우스 더블 클릭 이벤트를 처리하려면 이 설정을 재정의합니다. 마우스 더블 클릭 이벤트는 event 에서 제공됩니다.
[virtual] void QAbstract3DInputHandler::mouseMoveEvent(QMouseEvent *event, const QPoint &mousePos)
마우스 이동 이벤트를 처리하려면 이 값을 재정의합니다. 마우스 이동 이벤트는 event 에, 마우스 위치는 mousePos 에 제공됩니다.
[virtual] void QAbstract3DInputHandler::mousePressEvent(QMouseEvent *event, const QPoint &mousePos)
마우스 누르기 이벤트를 처리하려면 이 값을 재정의합니다. 마우스 누름 이벤트는 event 에서, 마우스 위치는 mousePos 에서 제공됩니다.
[virtual] void QAbstract3DInputHandler::mouseReleaseEvent(QMouseEvent *event, const QPoint &mousePos)
마우스 릴리스 이벤트를 처리하려면 이 값을 재정의합니다. 마우스 릴리스 이벤트는 event 에서, 마우스 위치는 mousePos 에서 제공됩니다.
[protected] int QAbstract3DInputHandler::prevDistance() const
마지막 두 입력 위치 사이의 맨해튼 길이를 반환합니다.
setPrevDistance()도 참조하세요 .
[protected] QPoint QAbstract3DInputHandler::previousInputPos() const
이전 입력 위치를 반환합니다.
setPreviousInputPos()도 참조하세요 .
[protected] void QAbstract3DInputHandler::setPrevDistance(int distance)
마지막 두 입력 위치 사이의 distance (맨해튼 길이)를 설정합니다.
prevDistance()도 참조하세요 .
[protected] void QAbstract3DInputHandler::setPreviousInputPos(const QPoint &position)
이전 입력 위치를 position 에 지정된 지점으로 설정합니다.
previousInputPos()도 참조하세요 .
[virtual] void QAbstract3DInputHandler::touchEvent(QTouchEvent *event)
터치 입력 이벤트를 처리하려면 이를 재정의합니다. 터치 이벤트는 event.
[virtual] void QAbstract3DInputHandler::wheelEvent(QWheelEvent *event)
휠 이벤트를 처리하려면 이를 재정의합니다. 휠 이벤트는 event 에서 제공됩니다.
© 2025 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.
