QScrollerProperties Class
QScrollerPropertiesクラスは、QScroller...続きを読む
| Header: | #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 を返します。
本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。
