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 Widgets에서의 제스처 처리 개요 및 애플리케이션에서 제스처를 사용하는 방법에 대한 정보는 ‘위젯 및 그래픽 뷰의 제스처’ 문서를 참조하십시오.
사용자는 동일한 핀치 제스처를 반복적으로 적용하는 대신, 입력 장치의 한 지점을 계속 터치한 상태에서 새로운 지점을 두 번째로 터치하여 제스처를 계속할 수 있습니다. 이 경우, 제스처 이벤트는 Qt::GestureUpdated 상태의 QPinchGesture 인스턴스를 포함하여 대상 객체에 계속 전달됩니다.
QPanGesture 및 QSwipeGesture도 참조하십시오 .
멤버 유형 문서
enum QPinchGesture::ChangeFlag
flags QPinchGesture::ChangeFlags
이 열거형은 제스처 객체의 속성에 발생할 수 있는 변경 사항을 설명합니다.
| 상수 | 값 | 설명 |
|---|---|---|
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도 참조하십시오 .
© 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.
