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의 제스처 처리에 대한 개요와 애플리케이션에서 제스처를 사용하는 방법에 대한 정보는 위젯과 그래픽 보기의 제 스처 문서를 참조하십시오.
제스처 속성
클래스에는 사용자가 제스처 관련 인수를 얻기 위해 쿼리할 수 있는 속성 목록이 있습니다. 예를 들어, 핀치 제스처에는 프로퍼티로 노출되는 배율이 있습니다.
사용자 지정 제스처 인식기 개발자는 제스처에 대한 추가 정보를 제공하기 위해 추가 속성을 추가할 수 있습니다. 이 작업은 QGesture 객체에 새 동적 속성을 추가하거나 QGesture 클래스(또는 그 하위 클래스 중 하나)를 서브클래싱하여 수행할 수 있습니다.
제스처 객체의 수명 주기
QGesture 인스턴스는 필요할 때 암시적으로 생성되며 Qt가 소유합니다. Qt는 특정 인스턴스를 파괴하고 이를 대체할 새로운 인스턴스를 생성할 수 있으므로 개발자는 이를 파괴하거나 나중에 사용하기 위해 저장해서는 안 됩니다.
등록된 제스처 인식기는 recognize() 함수를 통해 대상 객체에 대한 입력 이벤트를 모니터링하여 필요에 따라 제스처 객체의 속성을 업데이트합니다.
해당 제스처가 활성화되어 있거나 방금 취소된 경우 제스처 객체는 QGestureEvent 으로 대상 객체에 전달될 수 있습니다. 대상 객체에 대해 둘 이상의 제스처가 지원될 수 있으므로 전달되는 각 이벤트에는 제스처 객체 목록이 포함됩니다. Qt에서 이벤트가 처리되는 방식 때문에 제스처 이벤트는 다른 객체에 의해 필터링될 수 있습니다.
QGestureEvent 와 QGestureRecognizer 를참조하십시오 .
멤버 유형 문서
enum QGesture::GestureCancelPolicy
이 열거형은 제스처를 수락하면 다른 제스처가 자동으로 취소되는 방법을 설명합니다.
| Constant | 값 | 설명 |
|---|---|---|
QGesture::CancelNone | 0 | 이 제스처를 수락하면 다른 제스처는 영향을 받지 않습니다. |
QGesture::CancelAllInContext | 1 | 이 제스처를 수락하면 컨텍스트에서 활성화된 모든 제스처(제스처를 구독할 때 지정한 Qt::GestureFlag )가 취소됩니다. |
속성 문서
gestureCancelPolicy : QGesture::GestureCancelPolicy
이 프로퍼티는 제스처를 수락할 때 어떤 일이 일어날지 결정하는 정책을 담고 있습니다.
한 제스처를 수락하면 다른 대상에 속한 다른 제스처를 자동으로 취소할 수 있습니다. 이 정책은 일반적으로 다른 제스처를 취소하지 않도록 설정되며 컨텍스트에서 모든 활성 제스처를 취소하도록 설정할 수 있습니다. 예를 들어 모든 자식 위젯에 대해.
기능 액세스:
| QGesture::GestureCancelPolicy | gestureCancelPolicy() const |
| void | setGestureCancelPolicy(QGesture::GestureCancelPolicy policy) |
[read-only] gestureType : const Qt::GestureType
이 속성에는 제스처의 유형이 저장됩니다.
액세스 함수의 유형을 저장합니다:
| Qt::GestureType | gestureType() const |
[read-only] hasHotSpot : const bool
이 속성은 제스처에 핫스팟이 있는지 여부를 보유합니다.
액세스 함수가 있는지 여부를 저장합니다:
| bool | hasHotSpot() const |
hotSpot : QPointF
이 속성은 제스처 이벤트의 수신자를 찾는 데 사용되는 지점을 보유합니다.
핫스팟은 전역 좌표계의 한 지점이며, QWidget::mapFromGlobal() 또는 QGestureEvent::mapToGraphicsScene()을 사용하여 로컬 핫스팟을 가져옵니다.
핫스팟은 제스처 인식기가 제스처 이벤트를 QGraphicsObject 으로 전달할 수 있도록 설정해야 합니다.
함수에 액세스합니다:
| QPointF | hotSpot() const |
| void | setHotSpot(const QPointF &value) |
| void | unsetHotSpot() |
[read-only] state : const Qt::GestureState
이 프로퍼티는 제스처의 현재 상태를 저장합니다.
액세스 함수를 저장합니다:
| Qt::GestureState | state() const |
멤버 함수 문서
[explicit] QGesture::QGesture(QObject *parent = nullptr)
주어진 parent 으로 새 제스처 객체를 생성합니다.
QGesture 객체는 QGestureRecognizer::create() 함수의 제스처 인식기에 의해 생성됩니다.
[virtual noexcept] QGesture::~QGesture()
제스처 객체를 파괴합니다.
© 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.
