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 は 2 つの方法で使用できます：

• アイテムとの自動インタラクションを提供するために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.rotationプロパティの範囲を制限しますが、PinchEvent rotation プロパティは制限しません。
• pinch.dragAxis は、ドラッグが許可されない (Pinch.NoDrag)、水平 (Pinch.XAxis)、垂直 (Pinch.YAxis)、または両方 (Pinch.XAndYAxis) のいずれかを指定します。
• pinch.minimum およびpinch.maximum は、対応する軸に沿ってターゲットをドラッグできる範囲を制限します。

シグナル・ドキュメント

pinchFinished(PinchEvent pinch)

このシグナルは、ピンチエリアがピンチジェスチャーの終了を検出したときに発行されます。

pinch パラメータ（pinch プロパティとは異なります）には、ピンチのスケール、中心、角度など、ピンチ ジェスチャに関する情報が含まれます。

pinchStarted(PinchEvent pinch)

この信号は、ピンチエリアがピンチジェスチャーの開始を検出したときに発行されます。2つのタッチポイント（指）が検出され、それらがジェスチャー開始のしきい値（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 は、ジェスチャがユーザーがスマートズームに入りたいことを示すときはゼロより大きくなり、終了するときはゼロになります（通常、同じジェスチャで2つの状態を切り替えることができます）。