PinchArea QML Type
간단한 핀치 제스처 처리를 지원합니다. 더 보기...
Import Statement: | import QtQuick |
Inherits: |
속성
- enabled : bool
- pinch
- pinch.active : bool
- pinch.dragAxis : enumeration
- pinch.maximumRotation : real
- pinch.maximumScale : real
- pinch.maximumX : real
- pinch.maximumY : real
- pinch.minimumRotation : real
- pinch.minimumScale : real
- pinch.minimumX : real
- pinch.minimumY : real
- pinch.target : Item
신호
- pinchFinished(PinchEvent pinch)
- pinchStarted(PinchEvent pinch)
- pinchUpdated(PinchEvent pinch)
- smartZoom(PinchEvent pinch)
상세 설명
핀치영역 유형은 QtQuick 1.1에서 추가되었습니다.
핀치영역은 일반적으로 해당 항목에 대한 핀치 제스처 처리를 제공하기 위해 보이는 항목과 함께 사용되는 보이지 않는 항목입니다.
enabled 속성은 프록시된 항목에 대한 핀치 처리를 활성화 및 비활성화하는 데 사용됩니다. 비활성화하면 핀치 영역이 마우스/터치 이벤트에 투명해집니다.
핀치 영역은 두 가지 방식으로 사용할 수 있습니다:
pinch.target
설정하여 항목과 자동 상호작용 제공- onPinchStarted, onPinchUpdated, onPinchFinished 핸들러 사용
Qt 5.5부터 PinchArea는 운영체제의 기본 핀치 제스처 이벤트에 반응할 수 있지만, 그렇지 않은 경우 터치 이벤트에만 반응합니다.
PinchEvent, QNativeGestureEvent, QTouchEvent 를참조하십시오 .
속성 문서
enabled : bool |
이 속성은 항목이 핀치 제스처를 허용하는지 여부를 저장합니다.
이 속성의 기본값은 true입니다.
pinch
항목이 핀치 제스처에 반응하도록 하는 편리한 방법을 제공합니다.
pinch.target
드래그할 항목의 ID를 지정합니다.pinch.active
는 대상 항목이 현재 드래그되고 있는지 여부를 지정합니다.pinch.minimumScale
와pinch.maximumScale
는PinchEvent
scale 속성이 아닌 Item.scale 속성의 범위를 제한합니다.pinch.minimumRotation
및pinch.maximumRotation
은 Item.rotation 속성의 범위를 제한하지만PinchEvent
rotation 속성은 제한하지 않습니다.pinch.dragAxis
는 드래그 인이 허용되지 않는지(Pinch.NoDrag
), 가로로(Pinch.XAxis
), 세로로(Pinch.YAxis
) 또는 둘 다(Pinch.XAndYAxis
) 할 수 있는지 지정합니다.pinch.minimum
와pinch.maximum
는 해당 축을 따라 대상을 끌 수 있는 거리를 제한합니다.
신호 문서
pinchFinished(PinchEvent pinch) |
이 신호는 핀치 영역에서 핀치 제스처가 완료되었음을 감지하면 발산됩니다.
pinch 매개변수( pinch 속성과 동일하지 않음)는 핀치의 눈금, 중심 및 각도를 포함하여 핀치 제스처에 대한 정보를 제공합니다.
참고: 해당 핸들러는 onPinchFinished
입니다.
pinchStarted(PinchEvent pinch) |
이 신호는 핀치 영역에서 핀치 제스처가 시작되었음을 감지할 때, 즉 두 개의 터치 포인트(손가락)가 감지되고 제스처가 시작되기 위한 startDragDistance 임계값을 넘어 움직였을 때 전송됩니다.
pinch 매개변수( pinch 속성과 동일하지 않음)는 핀치의 눈금, 중심, 각도 등 핀치 제스처에 대한 정보를 제공합니다. pinchStarted
신호가 발생하면 이전 제스처의 결과와 관계없이 이 값은 기본값으로 재설정됩니다. 즉, pinch.scale은 1.0
, pinch.rotation은 0.0
이 됩니다. 제스처가 진행됨에 따라 pinchUpdated 은 이러한 기본값과의 편차를 보고합니다.
이 제스처를 무시하려면 pinch.accepted
속성을 false로 설정하세요. 제스처가 취소되고 더 이상 이벤트가 전송되지 않습니다.
참고: 해당 핸들러는 onPinchStarted
입니다.
pinchUpdated(PinchEvent pinch) |
이 신호는 핀치 영역에서 핀치 제스처가 변경된 것을 감지하면 전송됩니다.
pinch 매개변수는 핀치의 눈금, 중심, 각도 등 핀치 제스처에 대한 정보를 제공합니다. 이러한 값은 현재 제스처가 시작된 이후의 변경 사항만 반영하므로 pinch 속성의 최소 및 최대 제한에 의해 제한되지 않습니다.
참고: 해당 핸들러는 onPinchUpdated
입니다.
smartZoom(PinchEvent pinch) |
이 신호는 핀치 영역이 스마트 줌 제스처를 감지할 때 발생합니다. 이 제스처는 macOS와 같은 특정 운영 체제에서만 발생합니다.
pinch 매개변수는 제스처가 발생한 위치를 포함하여 핀치 제스처에 대한 정보를 제공합니다. pinch.scale
은 제스처가 사용자가 스마트 줌으로 들어가려는 것을 나타내면 0보다 커지고, 종료할 때는 0이 됩니다(일반적으로 두 상태 사이를 전환하는 데 동일한 제스처가 사용되더라도).
참고: 해당 핸들러는 onSmartZoom
입니다.
© 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.