QPinchGesture Class
QPinchGesture クラスは、ユーザーによるピンチジェスチャーを記述します。詳細...
| ヘッダー | #include <QPinchGesture> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake： | QT += widgets |
| 継承： | 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 におけるジェスチャ処理の概要と、アプリケーションでジェスチャを使用するための情報については、「ウィジェットとグラフィックス・ビューにおけるジェスチャ」を参照してください。
同じピンチ・ジェスチャーを繰り返し適用する代わりに、ユーザーは入力デバイスを 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も参照の こと。
© 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.
