QGesture Class
QGesture 클래스는 제스처를 나타내며, 해당 사용자 입력을 설명하는 속성을 포함하고 있습니다. 더 보기...
| 헤더: | #include <QGesture> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| 상속: | QObject |
| 상속받는 클래스: | QPanGesture, QPinchGesture, QSwipeGesture, QTapAndHoldGesture 및 QTapGesture |
공개 타입
| enum | GestureCancelPolicy { CancelNone, CancelAllInContext } |
속성
|
공개 함수
| QGesture(QObject *parent = nullptr) | |
| virtual | ~QGesture() |
| QGesture::GestureCancelPolicy | gestureCancelPolicy() const |
| Qt::GestureType | gestureType() const |
| bool | hasHotSpot() const |
| QPointF | hotSpot() const |
| void | setGestureCancelPolicy(QGesture::GestureCancelPolicy policy) |
| void | setHotSpot(const QPointF &value) |
| Qt::GestureState | state() const |
| void | unsetHotSpot() |
상세 설명
제스처 객체는 개발자가 직접 생성하지 않습니다. 이 객체들은 애플리케이션에 등록된 ` QGestureRecognizer ` 객체에 의해 생성됩니다. ` QGestureRecognizer::registerRecognizer()`을 참조하십시오.
Qt Widgets에서의 제스처 처리 개요 및 애플리케이션에서 제스처를 사용하는 방법에 대한 정보는 ‘위젯 및 그래픽 뷰의 제스처(Gestures in Widgets and Graphics View )’ 문서를 참조하십시오.
제스처 속성
이 클래스에는 사용자가 제스처별 인수를 얻기 위해 조회할 수 있는 속성 목록이 있습니다. 예를 들어, 핀치 제스처에는 속성으로 노출되는 배율 계수가 있습니다.
사용자 정의 제스처 인식기 개발자는 제스처에 대한 추가 정보를 제공하기 위해 속성을 추가할 수 있습니다. 이는 QGesture 객체에 새로운 동적 속성을 추가하거나, QGesture 클래스(또는 그 하위 클래스 중 하나)를 상속하여 수행할 수 있습니다.
제스처 객체의 수명 주기
QGesture 인스턴스는 필요할 때 암시적으로 생성되며 Qt가 소유합니다. Qt는 특정 인스턴스를 소멸시키고 이를 대체할 새로운 인스턴스를 생성할 수 있으므로, 개발자는 절대로 이를 직접 소멸시키거나 나중에 사용하기 위해 저장해 두어서는 안 됩니다.
등록된 제스처 인식기는 ` recognize()` 함수를 통해 대상 객체의 입력 이벤트를 모니터링하며, 필요에 따라 제스처 객체의 속성을 업데이트합니다.
해당 제스처가 활성화되어 있거나 방금 취소된 경우, 제스처 객체는 QGestureEvent 를 통해 대상 객체에 전달될 수 있습니다. 대상 객체에 대해 하나 이상의 제스처 지원이 활성화될 수 있으므로, 전달되는 각 이벤트에는 제스처 객체 목록이 포함됩니다. Qt에서 이벤트를 처리하는 방식 때문에, 제스처 이벤트는 다른 객체에 의해 필터링될 수 있습니다.
QGestureEvent 및 QGestureRecognizer도 참조하십시오 .
멤버 유형 문서
enum QGesture::GestureCancelPolicy
이 열거형은 특정 제스처를 수락하면 다른 제스처가 자동으로 취소되는 방식을 설명합니다.
| 상수 | 값 | 설명 |
|---|---|---|
QGesture::CancelNone | 0 | 이 제스처를 수락하면 다른 제스처에는 아무런 영향이 미치지 않습니다. |
QGesture::CancelAllInContext | 1 | 이 제스처를 수락하면 컨텍스트에서 활성화된 모든 제스처(제스처 구독 시 지정된 Qt::GestureFlag 를 따름)가 취소됩니다. |
속성 설명
gestureCancelPolicy : QGesture::GestureCancelPolicy
이 속성은 제스처를 수락했을 때 어떤 동작이 수행될지 결정하는 정책을 정의합니다.
하나의 제스처를 수락할 때 Qt는 다른 대상에 속한 다른 제스처를 자동으로 취소할 수 있습니다. 이 정책은 일반적으로 다른 제스처를 취소하지 않도록 설정되어 있으며, 해당 컨텍스트 내의 모든 활성 제스처를 취소하도록 설정할 수도 있습니다. 예를 들어, 모든 자식 위젯에 대해 적용됩니다.
액세스 함수:
| QGesture::GestureCancelPolicy | gestureCancelPolicy() const |
| void | setGestureCancelPolicy(QGesture::GestureCancelPolicy policy) |
[read-only] gestureType : Qt::GestureType
이 속성은 제스처의 유형을 나타냅니다.
액세스 함수:
| Qt::GestureType | gestureType() const |
[read-only] hasHotSpot : bool
이 속성은 제스처에 핫스팟이 있는지 여부를 나타냅니다.
액세스 기능:
| bool | hasHotSpot() const |
hotSpot : QPointF
이 속성은 제스처 이벤트의 수신자를 찾는 데 사용되는 좌표를 저장합니다.
핫스팟은 전역 좌표계의 한 점이며, 로컬 핫스팟을 얻으려면 QWidget::mapFromGlobal() 또는 QGestureEvent::mapToGraphicsScene()을 사용하십시오.
제스처 인식기가 핫스팟을 설정해야만 제스처 이벤트를 QGraphicsObject 로 전달할 수 있습니다.
액세스 함수:
| QPointF | hotSpot() const |
| void | setHotSpot(const QPointF &value) |
| void | unsetHotSpot() |
[read-only] state : Qt::GestureState
이 속성은 제스처의 현재 상태를 저장합니다.
액세스 함수:
| Qt::GestureState | state() const |
멤버 함수 설명서
[explicit] QGesture::QGesture(QObject *parent = nullptr)
지정된 ` parent`를 사용하여 새로운 제스처 객체를 생성합니다.
QGesture 객체는 제스처 인식기가 QGestureRecognizer::create() 함수 내에서 생성합니다.
[virtual noexcept] QGesture::~QGesture()
제스처 객체를 삭제합니다.
© 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.
