QAbstractAnimation Class

成员函数文档

QAbstractAnimation::QAbstractAnimation(QObject *parent = nullptr)

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

另请参阅 QVariantAnimation 和QAnimationGroup 。

[virtual noexcept] QAbstractAnimation::~QAbstractAnimation()

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

[signal] void QAbstractAnimation::currentLoopChanged(int currentLoop)

QAbstractAnimation currentLoop 是当前循环。

另请参阅 currentLoop() 和loopCount()。

int QAbstractAnimation::currentLoopTime() const

返回当前循环内的当前时间。时间范围从 0 到duration()。

另请参阅 duration() 和currentTime 。

[signal] void QAbstractAnimation::directionChanged(QAbstractAnimation::Direction newDirection)

QAbstractAnimation newDirection 是新方向。

另请参阅 direction 。

[pure virtual] int QAbstractAnimation::duration() const

这个纯虚拟函数返回动画的持续时间，并定义QAbstractAnimation 更新当前时间的持续时间。持续时间是局部的，不包括循环次数。

如果返回值为-1，则表示动画没有定义持续时间；动画应永久运行直至停止。这对于非时间驱动的动画或无法轻松预测持续时间的动画（例如游戏中事件驱动的音频播放）非常有用。

如果动画是并行的QAnimationGroup ，持续时间将是其所有动画中最长的持续时间。如果动画是连续的QAnimationGroup ，持续时间将是所有动画持续时间的总和。

另请参阅 loopCount 。

[override virtual protected] bool QAbstractAnimation::event(QEvent *event)

重实现：QObject::event(QEvent *e)。

[signal] void QAbstractAnimation::finished()

QAbstractAnimation 会在动画停止并结束后发出该信号。

该信号在stateChanged() 之后发出。

另请参见 stateChanged()。

QAnimationGroup *QAbstractAnimation::group() const

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

另请参见 QAnimationGroup::addAnimation()。

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

QAbstractAnimation 每当动画的状态从 变为 时，虚拟 () 函数就会发出该信号。oldState newState updateState

另请参阅 updateState() 。

[slot] void QAbstractAnimation::stop()

停止动画。动画停止后，会发出stateChanged() 信号，而state() 会返回 Stopped。当前时间不会改变。

如果动画在结束后自行停止（即currentLoopTime() ==duration() 和currentLoop() >loopCount() - 1），则会发出finished() 信号。

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

int QAbstractAnimation::totalDuration() const

返回动画的总时长和有效时长，包括循环次数。

另请参阅 duration() 和currentTime 。

[pure virtual protected] void QAbstractAnimation::updateCurrentTime(int currentTime)

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

另请参见 updateState()。

[virtual protected] void QAbstractAnimation::updateDirection(QAbstractAnimation::Direction direction)

当动画的方向发生改变时，QAbstractAnimation 会调用这个虚拟函数。direction 参数是新方向。

另请参阅 setDirection() 和direction()。

[virtual protected] void QAbstractAnimation::updateState(QAbstractAnimation::State newState, QAbstractAnimation::State oldState)

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

另请参见 start()、stop()、pause() 和resume()。