QScrollerProperties Class
QScrollerPropertiesクラスは、QScroller...続きを読む
| ヘッダー | #include <QScrollerProperties> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake： | QT += widgets |
パブリックな型
| enum | FrameRates { Fps60, Fps30, Fps20, Standard } |
| enum | OvershootPolicy { OvershootWhenScrollable, OvershootAlwaysOff, OvershootAlwaysOn } |
| enum | ScrollMetric { MousePressEventDelay, DragStartDistance, DragVelocitySmoothingFactor, AxisLockThreshold, ScrollingCurve, …, ScrollMetricCount } |
パブリック関数
| QScrollerProperties() | |
| QScrollerProperties(const QScrollerProperties &sp) | |
| virtual | ~QScrollerProperties() |
| QVariant | scrollMetric(QScrollerProperties::ScrollMetric metric) const |
| void | setScrollMetric(QScrollerProperties::ScrollMetric metric, const QVariant &value) |
| bool | operator!=(const QScrollerProperties &sp) const |
| QScrollerProperties & | operator=(const QScrollerProperties &sp) |
| bool | operator==(const QScrollerProperties &sp) const |
静的パブリックメンバ
| void | setDefaultScrollerProperties(const QScrollerProperties &sp) |
| void | unsetDefaultScrollerProperties() |
詳細説明
QScrollerProperties クラスはQScroller で使用されるパラメータを格納します。
デフォルトの設定はプラットフォームに依存しており、Qtはキネティックスクロールのプラットフォームの動作をエミュレートします。
慣習として、QScrollerPropertiesは物理単位（メートル、秒）であり、現在のDPIを使用してQScroller 。
QScrollerも参照して ください。
メンバ型ドキュメント
enum QScrollerProperties::FrameRates
この列挙型は、ドラッグまたはスクロール中に使用可能なフレームレートを記述します。
| 定数 | 値 | 説明 |
|---|---|---|
QScrollerProperties::Fps60 | 1 | 60 フレーム/秒 |
QScrollerProperties::Fps30 | 2 | 30 フレーム/秒 |
QScrollerProperties::Fps20 | 3 | 20フレーム/秒 |
QScrollerProperties::Standard | 0 | デフォルト値は 60 フレーム/秒（QAbstractAnimation に対応）。 |
enum QScrollerProperties::OvershootPolicy
この列挙型は、オーバーシュートの様々なモードを記述する。
| 定数 | 値 | 説明 |
|---|---|---|
QScrollerProperties::OvershootWhenScrollable | 0 | オーバーシュートは、コンテンツがスクロール可能な場合に可能である。これはデフォルトである。 |
QScrollerProperties::OvershootAlwaysOff | 1 | コンテンツがスクロール可能な場合でも、オーバーシュートは決して有効にならない。 |
QScrollerProperties::OvershootAlwaysOn | 2 | コンテンツがスクロール可能でない場合でも、オーバーシュートは常に有効になります。 |
enum QScrollerProperties::ScrollMetric
この列挙型には、さまざまなスクロールメトリックの型が含まれています。特に指定がない場合、setScrollMetric 関数は qreal 型のQVariant を期待します。
異なる値の背後にある概念の詳細については、QScroller ドキュメントを参照してください。
| 定数 | 値 | 説明 |
|---|---|---|
QScrollerProperties::MousePressEventDelay | 0 | これは、[s] でフリックジェスチャを開始するときに、マウス押下イベントが遅延される時間です。 ジェスチャがその時間内にトリガされた場合、マウスの押下またはリリースはスクロールされたオブジェクトに送信されません。その遅延時間後にトリガーされた場合は、遅延されたマウス押下とグローバル位置QPoint(-QWIDGETSIZE_MAX, -QWIDGETSIZE_MAX) でのフェイクリリースイベントが送信されます。ジェスチャがキャンセルされた場合は、遅延マウス押下と実際のリリースイベントの両方が送信されます。 |
QScrollerProperties::DragStartDistance | 1 | これは、m でフリック ジェスチャがトリガされるまでにタッチ ポイントまたはマウス ポイントが移動する必要のある最小距離です。 |
QScrollerProperties::DragVelocitySmoothingFactor | 2 | 新しいドラッグ速度が最終的なスクロール速度にどの程度含まれるかを表す値です。この値は0 と1 の間の範囲にする必要があります。値が低いほど、ドラッグ速度にスムージングが適用されます。 |
QScrollerProperties::AxisLockThreshold | 3 | 移動が軸の周りの角度の内側にある場合、移動を1つの軸に制限する。閾値は0 から1 の範囲でなければならない。 |
QScrollerProperties::ScrollingCurve | 4 | ユーザーが開始したフリックの後、スクロール速度を減速するときに使用されるQEasingCurve 。これは位置のイージングカーブであり、速度ではないことに注意してください。デフォルトはQEasingCurve::OutQuad で、速度の直線的な減少（1次微分）と一定の減速（2次微分）になります。 |
QScrollerProperties::DecelerationFactor | 5 | このファクターはスクローラーが0速度まで減速するのにかかる時間に影響します。実際の値は選択したScrollingCurveに依存します。ほとんどのタイプでは、0.1 から2.0 |
QScrollerProperties::MinimumVelocity | 6 | タッチを終了するかマウスを離した後にスクロールを開始するために必要な最小速度m/s 。 |
QScrollerProperties::MaximumVelocity | 7 | m/s で到達可能な最大速度です。 |
QScrollerProperties::MaximumClickThroughVelocity | 8 | これは、m/s におけるクリックスルーの最大許容スクロール速度である。これは、現在（ゆっくり）スクロールしているオブジェクトをクリックすると、スクロールが停止するだけでなく、クリックイベントがUIコントロールにも配信されることを意味します。これは指数関数型のスクロールカーブを使用する場合に便利です。 |
QScrollerProperties::AcceleratingFlickMaximumTime | 9 | これは、フリックジェスチャが加速フリックとして認識されるまでの最大時間（seconds ）です。ゼロに設定すると、そのようなジェスチャは検出されません。加速フリック」とは、すでにスクロールしているオブジェクトに対して実行されるフリック ジェスチャのことです。この場合、スクロール速度を加速するために、スクロール速度に AcceleratingFlickSpeedupFactor が乗算されます。 |
QScrollerProperties::AcceleratingFlickSpeedupFactor | 10 | 加速フリックが検出されると、現在の速度にこの数値が乗算されます。>= 1 である必要があります。 |
QScrollerProperties::SnapPositionRatio | 11 | これは、次の位置にスナップするために、ユーザーが2つのスナップポイント間の領域をドラッグしなければならない距離です。0.33 は、次の位置にスナップするために、スクロールが2つのスナップポイント間の距離の3分の1に到達しなければならないことを意味します。比率は0 と1 の間でなければならない。 |
QScrollerProperties::SnapTime | 12 | これはスクロール曲線の時間係数である。低い値はスクロールに時間がかかることを意味します。スクロール距離はこの値に依存しません。 |
QScrollerProperties::OvershootDragResistanceFactor | 13 | この値はマウスのドラッグと実際のスクロール領域の移動（オーバーシュート中）の間の係数である。係数は0 から1 の間でなければなりません。 |
QScrollerProperties::OvershootDragDistanceFactor | 14 | これはドラッグ中のオーバーシュート動作の最大距離です。実際のオーバーシュート距離は、この値にスクロールされたオブジェクトのビューポートサイズを乗じて計算されます。係数は0 と1 の間でなければなりません。 |
QScrollerProperties::OvershootScrollDistanceFactor | 15 | これは、スクロール中のオーバーシュート移動の最大距離です。実際のオーバーシュート距離は、この値とスクロールされたオブジェクトのビューポートサイズを掛け合わせて計算されます。係数は0 と1 の間でなければなりません。 |
QScrollerProperties::OvershootScrollTime | 16 | これは、完全なオーバーシュート・アニメーションを再生するために使用される時間（seconds ）です。 |
QScrollerProperties::HorizontalOvershootPolicy | 17 | これは水平オーバーシュート ポリシーです (OvershootPolicy を参照)。 |
QScrollerProperties::VerticalOvershootPolicy | 18 | これは水平オーバーシュート ポリシーです (OvershootPolicy を参照)。 |
QScrollerProperties::FrameRate | 19 | QScroller はQAbstractAnimation タイマーを内部的に使用して、すべてのスクロール操作を、同時にアクティブになる可能性のある他のアニメーションと同期させます。標準値である60フレーム/秒が速すぎる場合は、この設定で下げることができ、QAbstractAnimation と同期させることができます。ここでは、FrameRates enumの値のみが許可されることに注意してください。 |
QScrollerProperties::ScrollMetricCount | 20 | これは常に最後のエントリである。 |
メンバー関数ドキュメント
QScrollerProperties::QScrollerProperties()
新しいスクローラー・プロパティを構築する。
QScrollerProperties::QScrollerProperties(const QScrollerProperties &sp)
sp のコピーを作成する。
[virtual noexcept] QScrollerProperties::~QScrollerProperties()
スクローラーのプロパティを破棄する。
QVariant QScrollerProperties::scrollMetric(QScrollerProperties::ScrollMetric metric) const
metric スクローラー・プロパティの値を問い合わせる。
setScrollMetric() およびScrollMetricも参照 。
[static] void QScrollerProperties::setDefaultScrollerProperties(const QScrollerProperties &sp)
すべての新しいQScrollerProperties オブジェクトのスクロールプロパティをsp に設定します。
デフォルトコンストラクタが返すプラットフォームのデフォルトプロパティをオーバーライドするには、この関数を使用します。単一のスクロール・オブジェクトのスクロール・プロパティのみを変更したい場合は、QScroller::setScrollerProperties() を使用してください。
注意: この関数を呼び出しても、すでに存在するQScrollerProperties オブジェクトの内容は変更されません。
unsetDefaultScrollerProperties()も参照してください 。
void QScrollerProperties::setScrollMetric(QScrollerProperties::ScrollMetric metric, const QVariant &value)
metric ScrollerMetric の特定の値をvalue に設定する。
scrollMetric() およびScrollMetricも参照してください 。
[static] void QScrollerProperties::unsetDefaultScrollerProperties()
デフォルトコンストラクタが返すスクロールプロパティを、プラットフォームのデフォルトプロパティに戻します。
setDefaultScrollerProperties()も参照してください 。
bool QScrollerProperties::operator!=(const QScrollerProperties &sp) const
これらのスクローラー・プロパティがsp と異なる場合はtrue を返し、そうでない場合はfalse を返す。
QScrollerProperties &QScrollerProperties::operator=(const QScrollerProperties &sp)
これらのスクロールプロパティにsp を割り当て、これらのスクロールプロパティへの参照を返します。
bool QScrollerProperties::operator==(const QScrollerProperties &sp) const
これらのスクローラー・プロパティがsp と等しい場合はtrue を返し、そうでない場合はfalse を返す。
© 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.
