QTimeLine Class

//...
auto 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
auto 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 将重新进入“Running”状态，一旦进入事件循环，它将以固定间隔更新其当前时间、帧和值。

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

另请参阅 start()、updateInterval()、frameChanged() 以及valueChanged()。

void QTimeLine::setEndFrame(int frame)

将结束帧（即对应于时间轴末尾的帧，也就是当前值为 1 的帧）设置为frame 。

另请参阅 endFrame()、startFrame() 和setFrameRange()。

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

将时间轴的帧计数器设置为从startFrame 开始，到endFrame 结束。对于每个时间值，当您调用currentFrame()或frameForTime()时，QTimeLine 会通过使用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 表示当前值。value 是一个介于0.0和1.0之间的数值

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

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

返回时间点msec 对应的时间轴值。返回值会根据曲线形状而有所不同，但始终介于0和1之间。如果msec 为0，则默认实现始终返回0。

重写此函数以向时间轴提供自定义曲线形状。

另请参阅 easingCurve 和frameForTime()。