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)
詳細説明
PinchArea タイプはQtQuick 1.1 で追加されました。
PinchArea は不可視アイテムで、通常、可視アイテムのピンチジェスチャー処理を提供するために、可視アイテムと共に使用されます。
enabled プロパティは、プロキシされたアイテムのピンチ処理を有効または無効にするために使用されます。無効にすると、ピンチ領域はマウス/タッチ イベントに対して透明になります。
PinchArea は 2 つの方法で使用できます:
- アイテムとの自動インタラクションを提供するために
pinch.target
を設定する。 - onPinchStarted, onPinchUpdated, onPinchFinished ハンドラを使用する。
Qt 5.5 以降、PinchArea は、オペレーティング・システムからのネイティブなピンチ・ジェスチャー・イベントがあれば、それに反応することができます。
それ以外の 場合は、 タッチイベントのみに反応します。PinchEvent 、QNativeGestureEvent 、QTouchEventも参照してください 。
プロパティ ドキュメント
enabled : bool |
このプロパティは、アイテムがピンチジェスチャーを受け入れるかどうかを保持します。
このプロパティのデフォルトは true です。
pinch
は、アイテムをピンチジェスチャーに反応させる便利な方法を提供します。
pinch.target
ドラッグするアイテムの ID を指定します。pinch.active
は、対象のアイテムが現在ドラッグされているかどうかを指定します。pinch.minimumScale
および はItem.scaleプロパティの範囲を制限しますが、 プロパティは制限しません。pinch.maximumScale
PinchEvent
scalepinch.minimumRotation
および 、Item.rotationプロパティの範囲を制限しますが、 プロパティは制限しません。pinch.maximumRotation
PinchEvent
rotationpinch.dragAxis
は、ドラッグを許可しない ( )、水平 ( )、垂直 ( )、または両方 ( ) のいずれかを指定します。Pinch.NoDrag
Pinch.XAxis
Pinch.YAxis
Pinch.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.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。