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 です。


© 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.