PinchArea QML Type

간단한 핀치 제스처 처리를 지원합니다. 더 보기...

• 상속된 멤버를 포함한 모든 멤버 목록

속성

• 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)

상세 설명

PinchArea는 일반적으로 표시된 항목과 함께 사용되어 해당 항목에 대한 핀치 제스처 처리를 제공하는 보이지 않는 항목입니다.

enabled 속성은 프록시된 항목에 대한 핀치 처리를 활성화하거나 비활성화하는 데 사용됩니다. 비활성화되면 핀치 영역은 마우스/터치 이벤트에 대해 투명해집니다.

PinchArea는 다음 두 가지 방법으로 사용할 수 있습니다:

• pinch.target 를 설정하여 항목과의 자동 상호작용을 제공하는 방법
• onPinchStarted, onPinchUpdated 및 onPinchFinished 핸들러 사용

Qt 5.5부터 PinchArea는 사용 가능한 경우 운영 체제의 네이티브 핀치 제스처 이벤트에 반응할 수 있으며, 그렇지 않은 경우 터치 이벤트에만 반응합니다.

PinchEvent, QNativeGestureEvent 및 QTouchEvent도 참조하십시오 .

속성 문서

enabled : bool

이 속성은 해당 항목이 핀치 제스처를 지원하는지 여부를 나타냅니다.

이 속성의 기본값은 true입니다.

pinch group

pinch 핀치 제스처에 반응하도록 항목을 설정하는 편리한 방법을 제공합니다.

• pinch.target 끌어올 대상 항목의 ID를 지정합니다.
• pinch.active 대상 항목이 현재 드래그 중인지 여부를 지정합니다.
• pinch.minimumScale pinch.maximumScale 는 Item.scale 속성의 범위를 제한하지만, 속성의 범위는 제한하지 않습니다. PinchEvent scale
• pinch.minimumRotation pinch.maximumRotation 는 Item.scale 속성의 범위를 제한하지만, 속성의 범위는 제한하지 않습니다. PinchEvent rotation
• pinch.dragAxis 드래그가 허용되지 않는지(Pinch.NoDrag), 수평 방향(Pinch.XAxis), 수직 방향(Pinch.YAxis), 또는 양쪽 모두(Pinch.XAndYAxis)에서 가능한지를 지정합니다.
• pinch.minimum 또한 pinch.maximum 는 대상 요소가 해당 축을 따라 드래그될 수 있는 최대 거리를 제한합니다.

Signal 문서

pinchFinished(PinchEvent pinch)

이 신호는 핀치 영역에서 핀치 제스처가 종료된 것을 감지했을 때 발생합니다.

pinch 매개변수( pinch 속성과는 다름)는 핀치 제스처의 배율, 중심 및 각도를 포함한 핀치 제스처에 대한 정보를 제공합니다.

pinchStarted(PinchEvent pinch)

이 신호는 핀치 영역에서 핀치 제스처가 시작된 것을 감지했을 때 발생합니다. 즉, 두 개의 터치 지점(손가락)이 감지되었고, 제스처가 시작되기 위한 ‘ startDragDistance ’ 임계값을 초과하여 이동한 경우입니다.

pinch 매개변수( pinch 속성과는 다름)는 핀치 제스처의 배율, 중심 및 각도를 포함한 핀치 제스처에 대한 정보를 제공합니다. pinchStarted 신호가 발생할 때, 이전 제스처의 결과와 관계없이 이러한 값들은 기본값으로 재설정됩니다. 즉, pinch.scale은 1.0, pinch.rotation은 0.0 이 됩니다. 제스처가 진행됨에 따라 pinchUpdated 는 이러한 기본값과의 편차를 보고합니다.

이 제스처를 무시하려면 pinch.accepted 속성을 false로 설정하십시오. 그러면 제스처가 취소되고 더 이상 이벤트가 전송되지 않습니다.

pinchUpdated(PinchEvent pinch)

이 신호는 핀치 영역에서 핀치 제스처의 변화가 감지되었을 때 발생합니다.

pinch 매개변수는 핀치 제스처의 배율, 중심 및 각도를 포함한 핀치 제스처에 대한 정보를 제공합니다. 이 값들은 현재 제스처가 시작된 이후의 변화만 반영하므로, pinch 속성의 최소 및 최대 제한값에 의해 제한받지 않습니다.

smartZoom(PinchEvent pinch)

이 신호는 핀치 영역에서 스마트 줌 제스처를 감지했을 때 발생합니다. 이 제스처는 macOS와 같은 특정 운영 체제에서만 발생합니다.

pinch 매개변수는 제스처가 발생한 위치를 포함하여 핀치 제스처에 대한 정보를 제공합니다. pinch.scale 는 사용자가 스마트 줌 모드로 진입하고자 할 때 0보다 큰 값을 가지며, 모드를 종료할 때는 0이 됩니다(일반적으로 두 상태 간 전환에 동일한 제스처가 사용되더라도 마찬가지입니다).