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。currentTime 的值将保持不变，直到调用resume() 或start()。如果要从当前时间点继续播放，请调用resume()。

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

[slot] void QAbstractAnimation::resume()

在动画暂停后将其恢复。当动画恢复时，会发出stateChanged()信号。currentTime 属性不会发生变化。

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

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

如果paused 为真，则动画暂停；如果paused 为假，则动画恢复。

另请参阅 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()。