QTimeLine 类

...
progressBar = new QProgressBar(this);
progressBar->setRange(0, 100);

// Construct a 1-second timeline with a frame range of 0 - 100
QTimeLine *timeLine = new QTimeLine(1000, this);
timeLine->setFrameRange(0, 100);
connect(timeLine, &QTimeLine::frameChanged, progressBar, &QProgressBar::setValue);

// Clicking the push button will start the progress bar animation
pushButton = new QPushButton(tr("Start animation"), this);
connect(pushButton, &QPushButton::clicked, timeLine, &QTimeLine::start);
...

成员函数文档

[显式] QTimeLine::QTimeLine(int duration = 1000, QObject *parent = nullptr)

以duration毫秒的时长构造时间轴。parent传递给QObject构造函数。默认时长为1000毫秒。

[虚函数 noexcept] QTimeLine::~QTimeLine()

销毁时间轴。

int QTimeLine::currentFrame() const

返回与当前时间对应的帧。

另请参阅：currentTime()，frameForTime()和setFrameRange()

qreal QTimeLine::currentValue() const

返回与当前时间对应的值。

另请参阅：valueForTime()和currentFrame()

int QTimeLine::endFrame() const

返回结束帧，即时间轴结束时的帧（即当前值为1的帧）。

另请参阅：setEndFrame()和setFrameRange()

[私有信号] void QTimeLine::finished()

当QTimeLine完成（即达到时间线的末端）并不会循环时，会发出此信号。

[私有信号] void QTimeLine::frameChanged(int frame)

当QTimeLine处于运行中状态时，它会以常规间隔发出此信号，但只有当前帧发生变化时才会如此。frame是当前帧号。

另请参阅：QTimeLine::setFrameRange() 和 QTimeLine::updateInterval。

int QTimeLine::frameForTime(int msec) const

返回对应于时间msec的帧。此值使用线性插值根据valueForTime返回的值计算得出。

另请参阅：valueForTime 和 setFrameRange。

[槽函数] void QTimeLine::resume()

从当前时间恢复时间线。在QTimeLine中，将再次进入运行状态，并进入事件循环后，将按常规间隔更新其当前时间、帧和值。

与start相反，此函数在恢复之前不会重新启动时间线。

另请参阅：start、updateInterval、frameChanged 和 valueChanged。

void QTimeLine::setEndFrame(int frame)

设置结束帧，即时间线末端的帧（即当前值为1的帧），为frame。

另请参阅：endFrame、startFrame 和 setFrameRange。

void QTimeLine::setFrameRange(int startFrame, int endFrame)

将时间线的帧计数器设置为从startFrame开始，并在endFrame结束。对于每个时间值，QTimeLine将使用valueForTime返回的值通过插值找到对应的帧，当调用currentFrame() 或 frameForTime时。

当在运行状态时，如果帧发生变化，QTimeLine还会发出frameChanged()信号。

另请参阅：startFrame、endFrame、start 和 currentFrame。

[槽函数] void QTimeLine::setPaused(bool paused)

如果 paused 为 true，时间线将被暂停，导致 QTimeLine 进入暂停状态。只有在调用 start() 或 setPaused(false) 之后，才会发出更新信号。如果 paused 为 false，时间线将继续运行，并从上次停止的地方继续。

另请参阅state() 和 start()。

void QTimeLine::setStartFrame(int frame)

设置起始帧，即对应于时间线开始（即，当前值为 0 的帧）的帧，为 frame。

另请参阅startFrame()，endFrame() 及 setFrameRange()。

[slot] void QTimeLine::start()

启动时间线。 QTimeLine 将进入运行状态，一旦进入事件循环，它将按固定时间间隔更新当前时间、帧和值。默认间隔为 40 毫秒（即每秒 25 次）。您可以通过调用 setUpdateInterval() 来更改更新间隔。

时间线将从位置 0 开始，或向后移动时的末尾。如果您想在不重新启动的情况下恢复停止的时间线，则可以调用 resume()。

另请参阅resume()，updateInterval()，frameChanged() 及 valueChanged()。

int QTimeLine::startFrame() const

返回起始帧，即对应于时间线开始（即，当前值为 0 的帧）的帧。

另请参阅setStartFrame() 和 setFrameRange()。

QTimeLine::State QTimeLine::state() const

返回时间线的状态。

另请参阅start()，setPaused() 以及 stop()。

[private signal] void QTimeLine::stateChanged(QTimeLine::State newState)

每次 QTimeLine 的状态发生变化时都会发出此信号。新状态是 newState。

[slot] void QTimeLine::stop()

停止时间线，导致 QTimeLine 进入 NotRunning 状态。

另请参阅start()。

[override virtual protected] void QTimeLine::timerEvent(QTimerEvent *event)

重写: QObject::timerEvent(QTimerEvent *event)。

[slot] void QTimeLine::toggleDirection()

切换时间线的方向。如果方向是向前，它将变为向后，反之亦然。

现有的 direction 绑定将移除。

另请参阅setDirection。

[私有信号] void QTimeLine::valueChanged(qreal value)

QTimeLine 在 运行 状态下以固定间隔发出此信号，但如果当前值发生变化，则只发出此信号。 value 是当前值。 value 是介于 0.0 和 1.0 之间的数字

另请参阅 QTimeLine::setDuration(), QTimeLine::valueForTime() 和 QTimeLine::updateInterval。

[虚函数] qreal QTimeLine::valueForTime(int msec) const

返回时间 msec 的时间线值。返回的值（取决于曲线形状）始终在 0 到 1 之间。如果 msec 为 0，则默认实现始终返回 0。

重新实现此函数以为您的时间线提供自定义曲线形状。

另请参阅 easingCurve 和 frameForTime。