QPinchGesture Class
QPinchGesture クラスは、ユーザーによるピンチジェスチャーを記述します。詳細...
| Header: | #include <QPinchGesture> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Inherits: | QGesture |
パブリックタイプ
| enum | ChangeFlag { ScaleFactorChanged, RotationAngleChanged, CenterPointChanged } |
| flags | ChangeFlags |
プロパティ
|
|
パブリック関数
| virtual | ~QPinchGesture() |
| QPointF | centerPoint() const |
| QPinchGesture::ChangeFlags | changeFlags() const |
| QPointF | lastCenterPoint() const |
| qreal | lastRotationAngle() const |
| qreal | lastScaleFactor() const |
| qreal | rotationAngle() const |
| qreal | scaleFactor() const |
| void | setCenterPoint(const QPointF &value) |
| void | setChangeFlags(QPinchGesture::ChangeFlags value) |
| void | setLastCenterPoint(const QPointF &value) |
| void | setLastRotationAngle(qreal value) |
| void | setLastScaleFactor(qreal value) |
| void | setRotationAngle(qreal value) |
| void | setScaleFactor(qreal value) |
| void | setStartCenterPoint(const QPointF &value) |
| void | setTotalChangeFlags(QPinchGesture::ChangeFlags value) |
| void | setTotalRotationAngle(qreal value) |
| void | setTotalScaleFactor(qreal value) |
| QPointF | startCenterPoint() const |
| QPinchGesture::ChangeFlags | totalChangeFlags() const |
| qreal | totalRotationAngle() const |
| qreal | totalScaleFactor() const |
詳細説明
ピンチ・ジェスチャーは、タッチ・ユーザー入力の一形態で、ユーザーは通常、親指と指で入力デバイス上の 2 点をタッチしてから、それらを近づけたり遠ざけたりして、ユーザー・インターフェースの倍率、ズーム、または詳細レベルを変更します。
Qt におけるジェスチャ処理の概要と、アプリケーションでジェスチャを使用する方法については、「Gestures in Widgets and Graphics View」を参照してください。
同じピンチ・ジェスチャーを繰り返し適用する代わりに、ユーザーは入力デバイスを 1 か所でタッチし続け、新しいポイントに 2 回目のタッチを適用してジェスチャーを継続することができます。この場合、Qt::GestureUpdated 状態の QPinchGesture のインスタンスを含むターゲット オブジェクトに、ジェスチャ イベントが配信され続けます。
QPanGesture およびQSwipeGestureも参照してください 。
メンバ型ドキュメント
enum QPinchGesture::ChangeFlag
flags QPinchGesture::ChangeFlags
この enum は、ジェスチャオブジェクトのプロパティに発生する可能性のある変更を記述します。
| 定数 | 値 | 説明 |
|---|---|---|
QPinchGesture::ScaleFactorChanged | 0x1 | scaleFactor によって保持されるスケールファクタが変更されました。 |
QPinchGesture::RotationAngleChanged | 0x2 | rotationAngle によって保持される回転角度が変更されました。 |
QPinchGesture::CenterPointChanged | 0x4 | centerPoint が保持する中心点が変更された。 |
ChangeFlags 型はQFlags<ChangeFlag> の typedef です。これは ChangeFlag 値の OR の組み合わせを格納する。
changeFlags およびtotalChangeFlagsも参照のこと 。
プロパティの説明
centerPoint : QPointF
このプロパティは、現在の中心点を保持します。
中心点は、ジェスチャーの 2 つの入力点の間の中間点です。
アクセス関数：
| QPointF | centerPoint() const |
| void | setCenterPoint(const QPointF &value) |
startCenterPoint およびlastCenterPointも参照して ください。
changeFlags : ChangeFlags
このプロパティは、現在のステップで変更されたジェスチャのプロパティを保持します。
このプロパティは、前のジェスチャ イベントにこのジェスチャに関する情報が含まれていたときから、他のどのプロパティが変更されたかを示しま す。この情報を使用して、ユーザー インターフェイスのどの側面を更新する必要があるかを判断できます。
アクセス関数：
| QPinchGesture::ChangeFlags | changeFlags() const |
| void | setChangeFlags(QPinchGesture::ChangeFlags value) |
totalChangeFlags 、scaleFactor 、rotationAngle 、centerPointも参照して ください。
lastCenterPoint : QPointF
このプロパティは、このジェスチャ用に記録された中心点の最後の位置を保持します。
アクセス関数：
| QPointF | lastCenterPoint() const |
| void | setLastCenterPoint(const QPointF &value) |
centerPoint およびstartCenterPoint も参照して ください。
lastRotationAngle : qreal
このプロパティは、ジェスチャ動作によってカバーされた、最後に報告された角度を保持します。
最後の回転角度は、このジェスチャに対して以前のジェスチャイベントが配信されたときにrotationAngle プロパティで報告された角度です。
アクセス関数：
| qreal | lastRotationAngle() const |
| void | setLastRotationAngle(qreal value) |
rotationAngle およびtotalRotationAngleも参照してください 。
lastScaleFactor : qreal
このプロパティは、このジェスチャに対して記録された最後のスケールファクタを保持します。
最後のスケールファクタには、以前のジェスチャイベントにこのジェスチャに関する情報が含まれていたときにscaleFactor プロパティで報告されたスケールファクタが含まれます。
このジェスチャに関する情報を含む以前のイベントが配信されなかった場合（つまり、このジェスチャ オブジェクトにジェスチャの最初の動きに関する情報が含まれている場合）、このプロパティには 0 が格納されます。
アクセス関数：
| qreal | lastScaleFactor() const |
| void | setLastScaleFactor(qreal value) |
scaleFactor およびtotalScaleFactorも参照してください 。
rotationAngle : qreal
このプロパティは、ジェスチャの動きによってカバーされる角度を保持します。
アクセス関数：
| qreal | rotationAngle() const |
| void | setRotationAngle(qreal value) |
totalRotationAngle およびlastRotationAngle も参照して ください。
scaleFactor : qreal
このプロパティは、現在のスケールファクターを保持します。
スケールファクターは、タッチデバイス上の2つのユーザー入力間の距離に関連するスケールファクターを測定します。
アクセス関数：
| qreal | scaleFactor() const |
| void | setScaleFactor(qreal value) |
totalScaleFactor およびlastScaleFactorも参照して ください。
startCenterPoint : QPointF
このプロパティは、中心点の開始位置を保持します。
アクセス関数：
| QPointF | startCenterPoint() const |
| void | setStartCenterPoint(const QPointF &value) |
centerPoint およびlastCenterPoint も参照して ください。
totalChangeFlags : ChangeFlags
このプロパティは、変更があったジェスチャのプロパティを保持します。
このプロパティは、ジェスチャが開始してから他のどのプロパティが変更されたかを示します。この情報を使用して、ユーザー インターフェイスのどの側面を更新する必要があるかを判断できます。
アクセス関数：
| QPinchGesture::ChangeFlags | totalChangeFlags() const |
| void | setTotalChangeFlags(QPinchGesture::ChangeFlags value) |
changeFlags 、scaleFactor 、rotationAngle 、centerPointも参照して ください。
totalRotationAngle : qreal
このプロパティは、ジェスチャによってカバーされる合計角度を保持します。
この合計角度は、ジェスチャによってカバーされる完全な角度を測定します。通常は、rotationAngle プロパティが保持する値と等しくなります。ただし、前述のように、ユーザーがタッチ・ポイントの1つを削除して再配置することにより、複数の回転を実行する場合を除きます。この場合、合計角度はジェスチャーの複数段階の回転角度の合計になります。
アクセス関数：
| qreal | totalRotationAngle() const |
| void | setTotalRotationAngle(qreal value) |
rotationAngle およびlastRotationAngleも参照してください 。
totalScaleFactor : qreal
このプロパティは、合計スケールファクターを保持します。
合計スケールファクターは、元の値から現在のスケールファクターまでのスケールファクターの変化の合計を測定します。
アクセス関数：
| qreal | totalScaleFactor() const |
| void | setTotalScaleFactor(qreal value) |
scaleFactor およびlastScaleFactor も参照 。
本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。
