QAbstractAnimation 类

成员函数文档

QAbstractAnimation::QAbstractAnimation(QObject *parent = nullptr)

构造QAbstractAnimation基类，并将parent传递给QObject的构造函数。

另请参阅：QVariantAnimation和QAnimationGroup。

[虚拟 noexcept] QAbstractAnimation::~QAbstractAnimation()

如果动画正在运行，则停止动画，然后销毁QAbstractAnimation。如果动画是QAnimationGroup的一部分，则在销毁之前会自动将其删除。

[信号] void QAbstractAnimation::currentLoopChanged(int currentLoop)

QAbstractAnimation 每当当前循环改变时都会发出此信号。 currentLoop 是当前循环。

另请参阅：currentLoop() 和 loopCount。

int QAbstractAnimation::currentLoopTime() const

返回当前循环中的当前时间。它可以从 0 到 duration ()。

另请参阅：duration() 和 currentTime。

[信号] void QAbstractAnimation::directionChanged(QAbstractAnimation::Direction newDirection)

QAbstractAnimation 每当方向改变时都会发出此信号。 newDirection 是新的方向。

另请参阅方向.

[纯虚] int QAbstractAnimation::duration() const

此纯虚函数返回动画的持续时间，并定义 QAbstractAnimation 应更新当前时间的时长。此时长是局部的，不包括循环计数。

返回值为 -1 表示动画没有定义的持续时间；动画应持续运行，直到停止。这对于非时间驱动的动画或难以预测其持续时间的动画很有用（例如，游戏中由事件驱动的音频播放）。

如果动画是并行 QAnimationGroup，则持续时间将是所有动画中最长的持续时间。如果动画是顺序 QAnimationGroup，则持续时间将是所有动画持续时间之和。

另请参阅：loopCount。

[重载虚保护函数] bool QAbstractAnimation::event(QEvent *event)

重写：QObject::event(QEvent *e)。

[信号] void QAbstractAnimation::finished()

QAbstractAnimation 在动画停止并到达结束时发出此信号。

在 stateChanged 之后发出此信号。

另请参阅：stateChanged。

QAnimationGroup *QAbstractAnimation::group() const

如果此动画是 QAnimationGroup 的一部分，则此函数返回组指针；否则返回 nullptr。

另请参阅：QAnimationGroup::addAnimation。

[槽] void QAbstractAnimation::pause()

暂停动画。当动画暂停时，state() 返回 Paused。直到调用 resume() 或 start()，currentTime 的值将保持不变。若要从当前时间继续，请调用 resume

另请参阅start()，state() 及 resume()。

[slot] void QAbstractAnimation::resume()

在动画暂停后恢复动画。当动画恢复时，它将发出 resumed() 和 stateChanged() 信号。当前时间将保持不变。

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

[slot] void QAbstractAnimation::setPaused(bool paused)

如果 paused 为 true，则动画将暂停。如果 paused 为 false，则动画将恢复。

另请参阅state()，pause() 和 resume()。

[slot] void QAbstractAnimation::start(QAbstractAnimation::DeletionPolicy policy = KeepWhenStopped)

开始动画。参数 policy 指示动画完成后是否应该被删除。当动画开始时，将发出 stateChanged() 信号，并且 state() 返回 Running。当控制达到事件循环时，动画将自行运行，在动画进行期间，定期调用 updateCurrentTime()。

如果动画目前处于停止状态或已达到末尾，调用 start() 将回放动画并从开始处重新开始。当动画达到末尾时，动画将停止，或者如果循环级别超过 1，它将回放并从开始处继续。

如果动画已经在运行，此函数将不起作用。

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

[signal] void QAbstractAnimation::stateChanged(QAbstractAnimation::State newState, QAbstractAnimation::State oldState)

QAbstractAnimationWhenever the state of the animation changes from oldState to newState，emit this signal. This signal is emitted after the virtual updateState() function is called.

另请参阅updateState()。

[slot] void QAbstractAnimation::stop()

停止动画。当动画停止时，它触发 stateChanged() 信号，并且 state() 返回 Stopped。当前时间不改变。

如果动画在达到结尾后自动停止（即 currentLoopTime() == duration() 并且 currentLoop() > loopCount() - 1），将触发 finished() 信号。

参见start() 和 state()。

int QAbstractAnimation::totalDuration() const

返回动画的总以及有效持续时间，包括循环次数。

另请参阅：duration() 和 currentTime。

[纯虚保护] void QAbstractAnimation::updateCurrentTime(int currentTime)

每当动画的 currentTime 发生改变时，都会调用这个纯虚函数。

另请参阅updateState()。

[虚保护] void QAbstractAnimation::updateDirection(QAbstractAnimation::Direction direction)

当动画的方向改变时，QAbstractAnimation 会调用此虚函数。其中 direction 参数是新的方向。

参见setDirection() 和 direction()。

[虚保护] void QAbstractAnimation::updateState(QAbstractAnimation::State newState, QAbstractAnimation::State oldState)

当动画的状态从 oldState 改变为 newState 时，QAbstractAnimation 会调用此虚函数。

参见start()，stop()，pause() 和 resume()。