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
です。
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.