QAbstractAnimation Class

成员函数

QAbstractAnimation::QAbstractAnimation(QObject *parent = Q_NULLPTR)

QAbstractAnimation 构造函数, parent 是父对象指针.

参见 QVariantAnimation 和 QAnimationGroup.

[virtual] QAbstractAnimation::~QAbstractAnimation()

若在运行中则停止动画, 然后销毁 QAbstractAnimation. 若当前动画是 QAnimationGroup 的一部分, 则会在销毁前被自动移除.

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

循环改变时, QAbstractAnimation 发出这个信号. currentLoop 为当前循环.

注意: 这个信号是属性 currentLoop 的通知信号.

参见 currentLoop() and loopCount().

int QAbstractAnimation::currentLoopTime() const

返回当前循环中的当前时间. 它的范围为0到 duration().

参见 duration() and currentTime.

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

动画方向改变时, QAbstractAnimation 发出这个信号. newDirection 是新方向.

注意: 这个信号是属性 direction 的通知信号.

参见 direction.

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

这个纯虚函数返回动画持续时间, 并定义 QAbstractAnimation 应该多久更新一次当前时间. 持续时间是本地的, 并且不包括循环总数.

返回值-1表示动画没有定义持续时间, 动画将永远运行下去, 直到被主动停止. 这对于非时间驱动的动画或者无法预测其持续时间的动画(例如., 游戏中事件驱动的音频回放)十分有用.

若这个动画是并行的 QAnimationGroup, 则持续时间是所有动画中最长的. 若这个动画是顺序的 QAnimationGroup, 则持续时间是所有动画的总和.

注意: 这个信号是属性 duration 的获取函数.

参见 loopCount.

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

QObject::event() 的重新实现.

[signal] void QAbstractAnimation::finished()

动画停止, 并到达终点后, QAbstractAnimation 发出这个信号.

这个信号在 stateChanged() 之后发送.

参见 stateChanged().

QAnimationGroup *QAbstractAnimation::group() const

若这个动画是 QAnimationGroup 的一部分, 则会返回 QAnimationGroup 的指针, 否则返回nullptr.

参见 QAnimationGroup::addAnimation().

[slot] void QAbstractAnimation::pause()

暂停动画. 动画暂停时, state() 返回 Paused. 调用 resume() 或 start() 前, currentTime 的值保持不变. 若想从当前时间继续, 则调用 resume() 函数.

参见 start(), state(), and resume().

[slot] void QAbstractAnimation::resume()

暂停后恢复动画. 动画恢复时, QAbstractAnimation会发出 resumed() 信号和 stateChanged() 信号. 当前时间不会变化.

参见 start(), pause(), and state().

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

若 paused 是 true , 则暂停动画. 若 paused 是 false , 则恢复动画.

参见 state(), pause(), and resume().

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

开始动画. policy 参数表示动画在结束后是否会被删除. 动画启动时, 会发出 stateChanged() 信号, state() 会返回 Running. 当控制权回到事件循环时, 动画会自动播放, 并随播放进度周期性调用 updateCurrentTime().

若动画当前已被停止或者已经结束, 调用 start() 将重置动画, 并从头开始. 当动画到达终点时, 动画将会停止; 或者当其循环次数大于1, 则会从头开始.

若动画已经在运行中, 这个函数不会有任何操作.

参见 stop() and state().

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

每当动画的状态从 oldState 变为 newState 时, QAbstractAnimation 会发出这个信号. 这个信号在调用虚函数 updateState()后发出.

注意: 这个信号是属性 state 的通知信号.

参见 updateState().

[slot] void QAbstractAnimation::stop()

停止动画. 动画停止时, QAbstractAnimation 会发出 stateChanged() 信号, state() 返回 Stopped. 当前时间不会变化.

若动画到达终点后自动结束 (如., currentLoopTime() == duration() 和 currentLoop() > loopCount() - 1), 则会发出 finished() 信号.

参见 start() and state().

int QAbstractAnimation::totalDuration() const

返回动画的有效持续时间, 包含循环次数.

参见 duration() and currentTime.

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

这个纯虚函数会在动画的 currentTime 发生变化时被调用.

参见 updateState().

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

这个虚函数会在 QAbstractAnimation 的播放方向改变时被调用. 参数 direction 表示新的方向.

参见 setDirection() and direction().

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

这个虚函数会在动画的状态改变从 oldState 切换为 newState 时被调用.

参见 start(), stop(), pause(), and resume().