Класс QAbstractAnimation

Класс QAbstractAnimation является базовым классом для всех анимаций. Подробнее...

Этот класс был введен в Qt 4.6.

• Список всех членов, включая наследуемые

Открытые типы

Свойства

Открытые функции

Открытые слоты

Сигналы

Защищенные функции

Переопределённые защищенные функции

Подробное описание

Класс определяет функции, общие для всех анимаций. Наследуя этот класс, вы можете создавать собственные анимации, которые подключаются к остальной части системы анимации.

Прогресс анимации определяется текущим временем (currentLoopTime()), которое измеряется в миллисекундах с начала анимации (0) до её конца (duration()). Значение обновляется автоматически во время выполнения анимации. Его также можно установить напрямую с помощью setCurrentTime().

В любой момент анимация находится в одном из трех состояний: Running, Stopped или Paused — как определено в перечислении State. Текущее состояние можно изменить, вызвав start(), stop(), pause() или resume(). Анимация всегда сбрасывает своё текущее время при запуске. Если она приостановлена, она продолжит работу с тем же текущим временем при возобновлении. Когда анимация остановлена, её нельзя возобновить, но она сохранит своё текущее время (пока не будет запущена снова). QAbstractAnimation будет излучать stateChanged() всякий раз, когда её состояние изменяется.

Анимация может повторяться любое количество раз, установив свойство loopCount. Когда текущее время анимации достигает её duration(), оно сбрасывается, и анимация продолжает работать. Значение loopCount равное 1 (значение по умолчанию) означает, что анимация будет выполнена один раз. Обратите внимание, что duration равное -1 означает, что анимация будет выполняться до остановки; текущее время будет увеличиваться бесконечно. Когда текущее время равно duration() и анимация находится в последнем цикле, она переходит в состояние Stopped, и излучается сигнал finished().

QAbstractAnimation предоставляет чистые виртуальные функции, используемые подклассами для отслеживания прогресса анимации: duration() и updateCurrentTime(). Функция duration() позволяет указать продолжительность анимации (как описано выше). Система анимации вызывает updateCurrentTime() при изменении текущего времени. Переопределяя эту функцию, вы можете отслеживать прогресс анимации. Обратите внимание, что интервал между вызовами или количество вызовов не определены; однако обычно это 60 обновлений в секунду.

Переопределяя updateState(), вы можете отслеживать изменения состояния анимации, что особенно полезно для анимаций, не управляемых временем.

См. также QVariantAnimation, QPropertyAnimation, QAnimationGroup и Фреймворк анимации.

Документация типа члена

enum QAbstractAnimation::DeletionPolicy

enum QAbstractAnimation::Direction

Этот перечисление описывает направление анимации, когда она находится в состоянии Running.

См. также direction.

enum QAbstractAnimation::State

Это перечисление описывает состояние анимации.

См. также state() и stateChanged().

Документация функции члена

QAbstractAnimation::QAbstractAnimation(QObject *parent = nullptr)

Конструктор базового класса QAbstractAnimation и передает parent в конструктор QObject.

См. также QVariantAnimation и QAnimationGroup.

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

QAbstractAnimation излучает этот сигнал всякий раз, когда изменяется текущая итерация. currentLoop — текущая итерация.

Примечание: Сигнал уведомления для свойства currentLoop.

См. также currentLoop() и loopCount().

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

QAbstractAnimation излучает этот сигнал всякий раз, когда изменяется направление. newDirection — новое направление.

Примечание: Сигнал уведомления для свойства direction.

См. также direction.

[signal] void QAbstractAnimation::finished()

QAbstractAnimation излучает этот сигнал после того, как анимация остановилась и достигла конца.

Этот сигнал излучается после stateChanged().

См. также stateChanged().

[slot] void QAbstractAnimation::pause()

Приостанавливает анимацию. Когда анимация приостановлена, state() возвращает Paused. Значение currentTime останется неизменным до тех пор, пока не будет вызвано resume() или start(). Если вы хотите продолжить с текущего времени, вызовите 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().

Примечание: Сигнал уведомления для свойства state.

См. также updateState().

[slot] void QAbstractAnimation::stop()

Останавливает анимацию. Когда анимация останавливается, она излучает сигнал stateChanged(), и state() возвращает Stopped. Текущее время не изменяется.

Если анимация останавливается сама после достижения конца (т.е., currentLoopTime() == duration() и currentLoop() > loopCount() - 1), излучается сигнал finished().

См. также start() и state().

[virtual] QAbstractAnimation::~QAbstractAnimation()

Останавливает анимацию, если она запущена, затем уничтожает QAbstractAnimation. Если анимация является частью QAnimationGroup, она автоматически удаляется перед уничтожением.

int QAbstractAnimation::currentLoopTime() const

Возвращает текущее время внутри текущего цикла. Оно может варьироваться от 0 до duration().

См. также duration() и currentTime.

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

Эта чисто виртуальная функция возвращает продолжительность анимации и определяет, как долго QAbstractAnimation должен обновлять текущее время. Эта продолжительность локальна и не включает количество циклов.

Возвращаемое значение -1 указывает, что у анимации нет определённой продолжительности; анимация должна работать вечно до остановки. Это полезно для анимаций, которые не управляются временем, или где нельзя легко предсказать её продолжительность (например, воспроизведение аудио в игре, управляемое событиями).

Если анимация является параллельной QAnimationGroup, её продолжительность будет максимальной из продолжительностей всех анимаций. Если анимация является последовательной QAnimationGroup, её продолжительность будет суммой продолжительностей всех анимаций.

Примечание: Функция-получатель для свойства duration.

См. также loopCount.

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

Реализует: QObject::event(QEvent *e).

QAnimationGroup *QAbstractAnimation::group() const

Если эта анимация является частью QAnimationGroup, эта функция возвращает указатель на группу; в противном случае, она возвращает nullptr.

См. также QAnimationGroup::addAnimation().

int QAbstractAnimation::totalDuration() const

Возвращает общую и эффективную продолжительность анимации, включая количество циклов.

См. также duration() и currentTime.

[pure virtual protected] void QAbstractAnimation::updateCurrentTime(int 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)

Эта виртуальная функция вызывается QAbstractAnimation, когда состояние анимации меняется с oldState на newState.

См. также start(), stop(), pause() и resume().