QPinchGesture Class
QPinchGesture 클래스는 사용자가 수행하는 핀치 제스처를 설명합니다. 더 보기...
| 헤더: | #include <QPinchGesture> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| 상속합니다: | QGesture |
공용 유형
| enum | ChangeFlag { ScaleFactorChanged, RotationAngleChanged, CenterPointChanged } |
| flags | ChangeFlags |
속성
|
|
공공 기능
| virtual | ~QPinchGesture() |
| QPointF | centerPoint() const |
| QPinchGesture::ChangeFlags | changeFlags() const |
| QPointF | lastCenterPoint() const |
| qreal | lastRotationAngle() const |
| qreal | lastScaleFactor() const |
| qreal | rotationAngle() const |
| qreal | scaleFactor() const |
| void | setCenterPoint(const QPointF &value) |
| void | setChangeFlags(QPinchGesture::ChangeFlags value) |
| void | setLastCenterPoint(const QPointF &value) |
| void | setLastRotationAngle(qreal value) |
| void | setLastScaleFactor(qreal value) |
| void | setRotationAngle(qreal value) |
| void | setScaleFactor(qreal value) |
| void | setStartCenterPoint(const QPointF &value) |
| void | setTotalChangeFlags(QPinchGesture::ChangeFlags value) |
| void | setTotalRotationAngle(qreal value) |
| void | setTotalScaleFactor(qreal value) |
| QPointF | startCenterPoint() const |
| QPinchGesture::ChangeFlags | totalChangeFlags() const |
| qreal | totalRotationAngle() const |
| qreal | totalScaleFactor() const |
상세 설명
핀치 제스처는 일반적으로 사용자가 엄지와 손가락으로 입력 장치의 두 점을 터치한 후 서로 가깝게 또는 멀리 이동하여 사용자 인터페이스의 배율, 확대/축소 또는 세부 수준을 변경하는 터치 사용자 입력의 한 형태입니다.
Qt의 제스처 처리에 대한 개요와 애플리케이션에서 제스처를 사용하는 방법에 대한 정보는 위젯 및 그래픽 보기의 제 스처 문서를 참조하십시오.
사용자는 동일한 핀치 제스처를 반복적으로 적용하는 대신 한 곳에서 입력 장치를 계속 터치하고 새로운 지점에 두 번째 터치를 적용하여 제스처를 계속할 수 있습니다. 이 경우 제스처 이벤트는 Qt::GestureUpdated 상태의 QPinchGesture 인스턴스를 포함하는 대상 개체에 계속 전달됩니다.
QPanGesture 및 QSwipeGesture 을참조하세요 .
멤버 유형 문서
열거형 QPinchGesture::ChangeFlag
플래그 QPinchGesture::ChangeFlags
이 열거형은 제스처 객체의 프로퍼티에 발생할 수 있는 변경 사항을 설명합니다.
| Constant | 값 | 설명 |
|---|---|---|
QPinchGesture::ScaleFactorChanged | 0x1 | scaleFactor 이 보유한 배율이 변경되었습니다. |
QPinchGesture::RotationAngleChanged | 0x2 | rotationAngle 이 보유한 회전 각도가 변경되었습니다. |
QPinchGesture::CenterPointChanged | 0x4 | centerPoint 이 보유한 중심점이 변경되었습니다. |
ChangeFlags 유형은 QFlags<ChangeFlag>에 대한 typedef입니다. ChangeFlag 값의 OR 조합을 저장합니다.
changeFlags 및 totalChangeFlags 을참조하십시오 .
속성 문서
centerPoint : QPointF
이 속성은 현재 중심점을 보유합니다.
중심점은 제스처의 두 입력 지점 사이의 중간 지점입니다.
함수에 액세스합니다:
| QPointF | centerPoint() const |
| void | setCenterPoint(const QPointF &value) |
startCenterPoint 및 lastCenterPoint 을참조하세요 .
changeFlags : ChangeFlags
이 속성은 현재 단계에서 변경된 제스처의 속성을 보유합니다.
이 속성은 이전 제스처 이벤트에 이 제스처에 대한 정보가 포함된 이후 다른 속성 중 어떤 것이 변경되었는지를 나타냅니다. 이 정보를 사용하여 사용자 인터페이스의 어느 부분을 업데이트해야 하는지 결정할 수 있습니다.
기능 액세스:
| QPinchGesture::ChangeFlags | changeFlags() const |
| void | setChangeFlags(QPinchGesture::ChangeFlags value) |
totalChangeFlags, scaleFactor, rotationAngle, 및 centerPoint 을참조하세요 .
lastCenterPoint : QPointF
이 속성은 이 제스처에 대해 기록된 중심점의 마지막 위치를 보유합니다.
함수에 액세스합니다:
| QPointF | lastCenterPoint() const |
| void | setLastCenterPoint(const QPointF &value) |
centerPoint 및 startCenterPoint 을참조하십시오 .
lastRotationAngle : qreal
이 속성은 제스처 모션이 마지막으로 보고한 각도를 보유합니다.
마지막 회전 각도는 이 제스처에 대한 이전 제스처 이벤트가 전달되었을 때 rotationAngle 프로퍼티에 보고된 각도입니다.
함수에 액세스합니다:
| qreal | lastRotationAngle() const |
| void | setLastRotationAngle(qreal value) |
rotationAngle 및 totalRotationAngle 을참조하세요 .
lastScaleFactor : qreal
이 속성에는 이 제스처에 대해 마지막으로 기록된 배율이 저장됩니다.
마지막 배율은 이전 제스처 이벤트에 이 제스처에 대한 정보가 포함된 경우 scaleFactor 프로퍼티에 보고된 배율을 포함합니다.
이 제스처에 대한 정보가 포함된 이전 이벤트가 전달되지 않은 경우(즉, 이 제스처 객체에 제스처의 첫 번째 동작에 대한 정보가 포함된 경우) 이 속성은 0을 포함합니다.
함수에 액세스합니다:
| qreal | lastScaleFactor() const |
| void | setLastScaleFactor(qreal value) |
scaleFactor 및 totalScaleFactor 을참조하세요 .
rotationAngle : qreal
이 프로퍼티는 제스처 모션이 적용되는 각도를 유지합니다.
액세스 함수에 액세스합니다:
| qreal | rotationAngle() const |
| void | setRotationAngle(qreal value) |
totalRotationAngle 및 lastRotationAngle 을참조하세요 .
scaleFactor : qreal
이 속성은 현재 배율을 보유합니다.
배율은 터치 디바이스에서 두 사용자 입력 사이의 거리와 관련된 배율을 측정합니다.
함수에 액세스합니다:
| qreal | scaleFactor() const |
| void | setScaleFactor(qreal value) |
totalScaleFactor 및 lastScaleFactor 을참조하세요 .
startCenterPoint : QPointF
이 속성은 중심점의 시작 위치를 보유합니다.
함수에 액세스합니다:
| QPointF | startCenterPoint() const |
| void | setStartCenterPoint(const QPointF &value) |
centerPoint 및 lastCenterPoint 을참조하세요 .
totalChangeFlags : ChangeFlags
이 속성은 변경된 제스처의 속성을 보유합니다.
이 속성은 제스처가 시작된 이후 변경된 다른 속성을 나타냅니다. 이 정보를 사용하여 사용자 인터페이스의 어떤 부분을 업데이트해야 하는지 결정할 수 있습니다.
기능 액세스:
| QPinchGesture::ChangeFlags | totalChangeFlags() const |
| void | setTotalChangeFlags(QPinchGesture::ChangeFlags value) |
changeFlags, scaleFactor, rotationAngle, centerPoint 을참조하세요 .
totalRotationAngle : qreal
이 속성은 제스처가 커버하는 전체 각도를 보유합니다.
이 총 각도는 제스처가 커버하는 전체 각도를 측정합니다. 일반적으로 이는 위에서 설명한 것처럼 사용자가 터치 포인트 중 하나를 제거하고 위치를 변경하여 여러 회전을 수행하는 경우를 제외하고 rotationAngle 속성이 보유한 값과 동일합니다. 이 경우 총 각도는 제스처의 여러 단계에 대한 회전 각도의 합이 됩니다.
기능에 액세스하기:
| qreal | totalRotationAngle() const |
| void | setTotalRotationAngle(qreal value) |
rotationAngle 및 lastRotationAngle 을참조하세요 .
totalScaleFactor : qreal
이 속성은 총 축척 계수를 보유합니다.
총 배율은 원래 값에서 현재 배율까지의 총 배율 변화를 측정합니다.
함수에 액세스합니다:
| qreal | totalScaleFactor() const |
| void | setTotalScaleFactor(qreal value) |
scaleFactor 및 lastScaleFactor 을참조하세요 .
© 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.
