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 は物理単位（メートル、秒）で指定され、QScroller によって現在の DPI を使用して変換されます。
QScrollerも参照してください 。
メンバ型のドキュメント
enum QScrollerProperties::FrameRates
この列挙型は、ドラッグやスクロール時に使用可能なフレームレートを定義します。
| 定数 | 値 | 説明 |
|---|---|---|
QScrollerProperties::Fps60 | 1 | 60 フレーム/秒 |
QScrollerProperties::Fps30 | 2 | 30 フレーム/秒 |
QScrollerProperties::Fps20 | 3 | 毎秒20フレーム |
QScrollerProperties::Standard | 0 | デフォルト値は 1 秒あたり 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 において、フリックジェスチャが「加速フリック」として認識されるまでの最大時間です。0に設定すると、そのようなジェスチャは検出されません。 「加速フリック」とは、すでにスクロールしているオブジェクトに対して実行されるフリックジェスチャのことです。このような場合、スクロール速度に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 列挙型の値のみであることにご注意ください。 |
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` を返します。
© 2026 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.
