QScroller 类

    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 可在视口内可见，并围绕 rect 的像素边缘指定额外的边距。

在不能将矩形及其边距完全放入视口的情况下，内容将滚动，以便尽可能多地从 rect 中可见。

滚动速度的计算以确保在平台定义的时间段后到达给定位置。

此函数通过调用 scrollTo() 执行实际的滚动。

另请参阅 scrollTo().

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

这是一个重载函数。

本版本将在 scrollTime 毫秒内到达目标位置。

QPointF QScroller::finalPosition() const

返回当前滚动动作的预计最终位置。如果滑块状态不是滚动，则返回当前位置。当滑块状态为非活动状态时，结果未定义。

目标位置以像素为单位。

另请参阅 pixelPerMeter() 和 scrollTo()。

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

注册自定义滚动手势识别器，为 target 获取它并返回所得到的手势类型。如果 scrollGestureType 设置为 TouchGesture，则手势在触摸事件上触发。如果它设置为 LeftMouseButtonGesture、RightMouseButtonGesture 或MiddleMouseButtonGesture，则在相应的鼠标按钮的鼠标事件上触发。

任何时刻单个对象上只能有一个滚动手势是活动的。如果您在同一对象上连续调用此函数两次，它将在获取新手势之前取消已获取的手势。

另请参阅 ungrabGesture() 和 grabbedGesture()。

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

返回当前为 target 抓取的手势类型，如果没有抓取任何手势，则返回 0。

另请参阅 grabGesture() 和 ungrabGesture()。

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

此函数用于由手势识别器通知滑块关于新的输入事件。滑块根据输入事件的类型及其附加的滑块属性更改其内部 状态()。滑块不区分事件来自哪种输入设备。因此，需要将事件分割为 input 类型、一个 position 和一个以毫秒为单位的 timestamp。该 position 需要位于目标的坐标系中。

如果事件应该被调用过滤器消耗，则返回值是 true；如果事件应该被转发到控件，则返回 false。

[静态] bool QScroller::hasScroller(QObject *target)

如果为目标 target 创建了一个 QScroller 对象，则返回 true；否则返回 false。

另请参阅 scroller。

QPointF QScroller::pixelPerMeter() const

返回滚动小部件的每米像素数。

该值分别通过使用 QPointF 分别报告 x 和 y 轴。

[槽] void QScroller::resendPrepareEvent()

此函数重新发送 QScrollPrepareEvent。调用 resendPrepareEvent 将从滚动器触发 QScrollPrepareEvent。这允许接收器在滚动时重新设置内容位置和内容大小。在非活动状态下调用此函数是无效的，因为滚动开始之前会再次发送准备事件。

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

开始滚动小部件，使点 pos 在视口中的左上角。

当滚动到有效滚动区域之外时，行为是未定义的。在这种情况下，滚动器可能过了界或没有过界。

滚动速度将计算，以便在平台定义的时间间隔后达到给定位置。

pos 以视口坐标给出。

另请参阅 ensureVisible。

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

这是一个重载函数。

本版本将在 scrollTime 毫秒内到达目标位置。

[静态] QScroller *QScroller::scroller(QObject *target)

返回给定的 target 的滚动器。只要对象存在，此函数总是会返回相同的 QScroller 实例。如果在 target 上没有为 QScroller 创建，则会隐式创建一个。在任何时候，一个对象都不会同时激活多个 QScroller。

另请参阅 hasScroller() 和 target。

[静态] const QScroller *QScroller::scroller(const QObject *target)

这是一个重载函数。

这是 scroller() 的常量版本。

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

每当 QScroller 的滚动器属性更改时，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可以停用快照功能。

[信号] void QScroller::stateChanged(QScroller::State newState)

QScroller在状态改变时发出此信号。newState是新的状态。

另请参阅state.

void QScroller::stop()

停止滚轴并将其状态重置为非活动。

QObject *QScroller::target() const

返回此滚轴的目标对象。

另请参阅hasScroller() 和 scroller。

[静态] void QScroller::ungrabGesture(QObject *target)

取消对target的手势请求。如果没有手势被请求，则不执行任何操作。

另请参阅grabGesture() 和 grabbedGesture。

QPointF QScroller::velocity() const

当状态为滚动或拖拽时，返回每秒钟的滚动速度（米）。否则返回零速度。

使用QPointF分别对x和y轴的速度进行报告。

另请参阅 pixelPerMeter。