QTimeLine Class

...
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);
...

成员函数文档

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

构建一个持续时间为duration 毫秒的时间线。parent 将传递给QObject 的构造函数。默认持续时间为 1000 毫秒。

[virtual noexcept] QTimeLine::~QTimeLine()

破坏时间线

int QTimeLine::currentFrame() const

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

另请参阅 currentTime()、frameForTime() 和setFrameRange()。

qreal QTimeLine::currentValue() const

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

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

int QTimeLine::endFrame() const

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

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

[private signal] void QTimeLine::finished()

QTimeLine 结束（即到达时间线的终点）时发出该信号，不会循环。

[private signal] void QTimeLine::frameChanged(int frame)

QTimeLine Running frame 是当前帧的编号。

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

int QTimeLine::frameForTime(int msec) const

返回与时间msec 相对应的帧。该值是根据valueForTime() 返回的值，使用开始帧和结束帧的线性插值计算得出的。

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

[slot] 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 都会在调用currentFrame() 或frameForTime() 时，利用valueForTime() 的返回值，通过插值找到相应的帧。

处于运行状态时，当帧发生变化时，QTimeLine 也会发出frameChanged() 信号。

另请参见 startFrame()、endFrame()、start() 和currentFrame()。

[slot] 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().

[private signal] void QTimeLine::valueChanged(qreal value)

QTimeLine Running value 是当前值。 是介于 0.0 和 1.0 之间的数字。value

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

[virtual] qreal QTimeLine::valueForTime(int msec) const

返回时间msec 的时间线值。返回值因曲线形状而异，总是介于 0 和 1 之间。如果msec 为 0，默认实现总是返回 0。

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

另请参阅 easingCurve 和frameForTime()。