QScroller Class

    QWidget *w = ...;
    QScroller::grabGesture(w, QScroller::LeftMouseButtonGesture);

    QWidget *w = ...;
    QScroller *scroller = QScroller::scroller(w);
    scroller->scrollTo(QPointF(100, 100));

メンバ関数ドキュメント

[static] QList<QScroller *> QScroller::activeScrollers()

現在アクティブなQScroller オブジェクトのアプリケーション全体のリストを返す。アクティブなQScroller オブジェクトは、QScroller::Inactive 以外のstate() にあります。この関数は、独自のジェスチャー認識器を書くときに便利です。

[slot] void QScroller::ensureVisible(const QRectF &rect, qreal xmargin, qreal ymargin)

矩形rect がビューポート内に見えるようにスクロールを開始し、矩形の周囲にxmargin とymargin でピクセル単位で指定された余白を追加する。

矩形と余白をビューポート内に収めることができない場合、コンテンツはrect から可能な限り見えるようにスクロールされる。

スクロール速度は、プラットフォームで定義された時間経過後に指定された位置に到達するように計算される。

この関数は、scrollTo （）を呼び出すことで、実際のスクロールを実行する。

scrollTo()も参照 。

[slot] void QScroller::ensureVisible(const QRectF &rect, qreal xmargin, qreal ymargin, int scrollTime)

これはオーバーロードされた関数である。

このバージョンはscrollTime ミリ秒で目的地の位置に到達する。

QPointF QScroller::finalPosition() const

現在のスクロール移動の推定最終位置を返します。スクローラーの状態が Scrolling でない場合は現在の位置を返します。スクローラーの状態が Inactive の場合、結果は未定義です。

目標位置の単位は pixel です。

pixelPerMeter() およびscrollTo()も参照 。

[static] Qt::GestureType QScroller::grabGesture(QObject *target, QScroller::ScrollerGestureType scrollGestureType = TouchGesture)

カスタムスクロールジェスチャレコグナイザを登録し、target 。scrollGestureType がTouchGesture に設定されている場合、ジェスチャはタッチ イベントでトリガされます。LeftMouseButtonGesture,RightMouseButtonGesture,MiddleMouseButtonGesture のいずれかに設定されている場合は、対応するボタンのマウス イベントでトリガーされます。

1つのオブジェクトで同時にアクティブにできるスクロール ジェスチャは1つだけです。同じオブジェクトでこの関数を 2 回呼び出すと、新しいジェスチャをつかむ前に既存のジェスチャが解除されます。

ungrabGesture() およびgrabbedGesture()も参照してください 。

[static] Qt::GestureType QScroller::grabbedGesture(QObject *target)

target で現在つかまれているジェスチャーの種類、またはジェスチャーがつかまれていない場合は 0 を返します。

grabGesture() およびungrabGesture()も参照してください 。

bool QScroller::handleInput(QScroller::Input input, const QPointF &position, qint64 timestamp = 0)

この関数は、ジェスチャ認識機能によって、新しい入力イベントをスクローラに通知するために使用されます。スクローラーは、入力イベントとそれに付随するスクローラーのプロパティに従って、内部のstate() を変更します。スクローラーは、イベントがどの入力デバイスから来たかを区別しません。そのため、イベントをinput タイプ、position 、ミリ秒timestamp に分割する必要があります。position はターゲットの座標系にある必要がある。

戻り値は、イベントが呼び出し元のフィルターで消費される場合はtrue 、イベントがコントロールに転送される場合はfalse 。

[static] bool QScroller::hasScroller(QObject *target)

QScroller オブジェクトがすでにtarget に対して作成されている場合はtrue を返し、そうでない場合はfalse を返す。

scroller()も参照のこと 。

QPointF QScroller::pixelPerMeter() const

スクロールされたウィジェットの1メートルあたりのピクセルを返します。

この値は、QPointF を使用して x 軸と y 軸の両方について別々に報告されます。

[slot] void QScroller::resendPrepareEvent()

この関数はQScrollPrepareEvent を再送する。 resendPrepareEvent を呼び出すと、スクローラーからQScrollPrepareEvent がトリガーされる。これにより、受信者はスクロール中にコンテンツの位置とサイズを再設定できる。スクロールが始まる前にprepareイベントが再度送信されるため、Inactive状態でこの関数を呼び出しても意味がない。

[slot] void QScroller::scrollTo(const QPointF &pos)

ポイントpos がビューポートの左上の位置になるように、ウィジェットのスクロールを開始します。

有効なスクロール領域の外側をスクロールする場合の動作は未定義です。この場合、スクロールはオーバーシュートするかもしれませんし、しないかもしれません。

スクロール速度は、プラットフォームで定義された時間経過後に指定された位置に到達するように計算されます。

pos はビューポート座標で指定します。

ensureVisible()も参照してください 。

[slot] void QScroller::scrollTo(const QPointF &pos, int scrollTime)

これはオーバーロードされた関数である。

このバージョンはscrollTime ミリ秒で目的地の位置に到達する。

[static] QScroller *QScroller::scroller(QObject *target)

与えられたtarget のスクローラーを返します。オブジェクトが存在する限り、この関数は常に同じQScroller インスタンスを返します。target に対応するQScroller が存在しない場合は、暗黙的に作成されます。1つのオブジェクトに対して複数のQScroller がアクティブになることはありません。

hasScroller() およびtarget()も参照 。

[static] const QScroller *QScroller::scroller(const QObject *target)

これはオーバーロードされた関数である。

これは scroller() の const バージョンである。

[signal] void QScroller::scrollerPropertiesChanged(const QScrollerProperties &newProperties)

QScroller newProperties は新しいスクローラのプロパティです。

scrollerPropertiesも参照してください 。

void QScroller::setSnapPositionsX(const QList<qreal> &positions)

横軸のスナップ位置をpositions のリストに設定する。 これは、以前に設定されたすべてのスナップ位置と、以前に設定されたスナップ間隔を上書きする。スナップは、位置の空のリストを設定することによって無効にすることができる。

void QScroller::setSnapPositionsX(qreal first, qreal interval)

横軸のスナップ位置を一定間隔に設定する。最初のスナップ位置はfirst です。次のスナップ位置はfirst +interval 。これはリストヘッダーを実装するために使用できます。これは、以前に設定されたすべてのスナップ位置と、以前に設定されたスナップ間隔を上書きします。スナップは0.0の間隔を設定することで無効にできます。

void QScroller::setSnapPositionsY(const QList<qreal> &positions)

垂直軸のスナップ位置をpositions のリストに設定する。 これは、以前に設定されたすべてのスナップ位置と、以前に設定されたスナップ間隔を上書きする。スナップは、位置の空のリストを設定することによって無効にすることができる。

void QScroller::setSnapPositionsY(qreal first, qreal interval)

縦軸のスナップ位置を一定間隔に設定する。最初のスナップ位置はfirst です。次のスナップ位置はfirst +interval 。これは、以前に設定されたすべてのスナップ位置と、以前に設定されたスナップ間隔を上書きします。スナップは、間隔を0.0に設定することで無効にできます。

[signal] void QScroller::stateChanged(QScroller::State newState)

QScroller newState が新しいステートです。

stateも参照してください 。

void QScroller::stop()

スクロールを停止し、その状態を非アクティブに戻す。

QObject *QScroller::target() const

このスクローラーのターゲットオブジェクトを返します。

hasScroller() およびscroller()も参照 ください。

[static] void QScroller::ungrabGesture(QObject *target)

target のジェスチャーを解除します。 ジェスチャーがつかまれていない場合は何もしません。

grabGesture() およびgrabbedGesture()も参照してください 。

QPointF QScroller::velocity() const

状態がスクロールまたはドラッグのとき、現在のスクロール速度をメートル毎秒で返します。それ以外の場合はゼロの速度を返す。

速度は、QPointF を使用して x 軸と y 軸の両方について別々に報告されます。

pixelPerMeter()も参照のこと 。