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 を設定して、アイテムとの自動的なインタラクションを実現する方法
• `xml-ph-0000@deepl.internal` を使用して、アイテムとの自動的なインタラクションを実現する

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)

このシグナルは、ピンチ領域がピンチジェスチャーの開始を検出したときに発行されます。つまり、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 は、ユーザーがスマートズームに入りたいことを示すジェスチャーの場合は0より大きく、終了する場合は0になります（通常、2つの状態を切り替えるには同じジェスチャーが使用されますが）。