Класс QAbstractAnimation

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

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

Типы

Свойства

• 1 свойство унаследовано от QObject

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

• 32 открытые функции унаследованы от QObject

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

• 1 открытый слот унаследован от QObject

Сигналы

• 2 сигнала унаследованы от QObject

Статические открытые члены

• 10 статических открытых членов унаследованы от QObject

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

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

• 9 защищенных функций унаследованы от QObject

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

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

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

Прогресс анимации определяется текущим временем (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.

[virtual] QAbstractAnimation::~QAbstractAnimation()

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

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

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

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

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

int QAbstractAnimation::currentLoopTime() const

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

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

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

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

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

См. также direction.

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

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

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

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

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

См. также loopCount.

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

Переопределено из QObject::event().

[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()

Возобновляет анимацию после её приостановки. При возобновлении анимации испускаются сигналы 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().

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)

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

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