PinchArea QML Type

簡単なピンチジェスチャー処理を有効にします。詳細...

Import Statement: import QtQuick
Inherits:

Item

プロパティ

シグナル

詳細説明

PinchArea タイプはQtQuick 1.1 で追加されました。

PinchArea は不可視アイテムで、通常、可視アイテムのピンチジェスチャー処理を提供するために、可視アイテムと共に使用されます。

enabled プロパティは、プロキシされたアイテムのピンチ処理を有効または無効にするために使用されます。無効にすると、ピンチ領域はマウス/タッチ イベントに対して透明になります。

PinchArea は 2 つの方法で使用できます:

  • アイテムとの自動インタラクションを提供するためにpinch.target を設定する。
  • onPinchStarted, onPinchUpdated, onPinchFinished ハンドラを使用する。

Qt 5.5 以降、PinchArea は、オペレーティング・システムからのネイティブなピンチ・ジェスチャー・イベントがあれば、それに反応することができます。

それ以外の 場合はタッチイベントのみに反応します。PinchEventQNativeGestureEventQTouchEventも参照してください

プロパティ ドキュメント

enabled : bool

このプロパティは、アイテムがピンチジェスチャーを受け入れるかどうかを保持します。

このプロパティのデフォルトは true です。


pinch group

pinch.active : bool [read-only]

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

pinch は、アイテムをピンチジェスチャーに反応させる便利な方法を提供します。

  • pinch.target ドラッグするアイテムの ID を指定します。
  • pinch.active は、対象のアイテムが現在ドラッグされているかどうかを指定します。
  • pinch.minimumScale および はItem.scaleプロパティの範囲を制限しますが、 プロパティは制限しません。pinch.maximumScale PinchEvent scale
  • pinch.minimumRotation および 、Item.rotationプロパティの範囲を制限しますが、 プロパティは制限しません。pinch.maximumRotation PinchEvent rotation
  • pinch.dragAxis は、ドラッグを許可しない ( )、水平 ( )、垂直 ( )、または両方 ( ) のいずれかを指定します。Pinch.NoDragPinch.XAxisPinch.YAxisPinch.XAndYAxis
  • pinch.minimum および は、対応する軸に沿ってターゲットをドラッグできる範囲を制限します。pinch.maximum

シグナルの説明

pinchFinished(PinchEvent pinch)

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

pinch パラメータ(pinch プロパティとは異なります)は、ピンチのスケール、中心、角度など、ピンチ ジェスチャに関する情報を提供します。

注: 対応するハンドラはonPinchFinished です。


pinchStarted(PinchEvent pinch)

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

注: 対応するハンドラはonSmartZoom です。


本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。