Класс QAnimationGroup

Класс QAnimationGroup — это абстрактный базовый класс для групп анимаций. Подробнее...

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

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

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

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

Группа анимаций — это контейнер для анимаций (подклассы QAbstractAnimation). Группа обычно отвечает за управление состоянием своих анимаций, то есть она решает, когда их запускать, останавливать, возобновлять и приостанавливать. В настоящее время Qt предоставляет две такие группы: QParallelAnimationGroup и QSequentialAnimationGroup. Обратитесь к описаниям их классов для получения подробностей.

Так как QAnimationGroup наследует от QAbstractAnimation, вы можете объединять группы и легко создавать сложные графики анимаций. Вы можете запросить у QAbstractAnimation группу, к которой она принадлежит (используя функцию group()).

Для запуска группы анимаций верхнего уровня просто используйте функцию start() из QAbstractAnimation. Под группами верхнего уровня мы подразумеваем группы, которые сами не содержатся в другой группе. Непосредственный запуск дочерних групп не поддерживается и может привести к неожиданному поведению.

QAnimationGroup предоставляет методы для добавления и извлечения анимаций. Кроме того, вы можете удалять анимации, вызывая removeAnimation(), и очищать группу анимаций, вызывая clear(). Вы можете отслеживать изменения в анимациях группы, прослушивая события QEvent::ChildAdded и QEvent::ChildRemoved.

QAnimationGroup берёт на себя управление управляемыми анимациями и гарантирует их удаление при удалении группы анимаций.

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

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

QAnimationGroup::QAnimationGroup(QObject *parent = nullptr)

Создаёт QAnimationGroup. parent передаётся конструктору QObject.

[virtual] QAnimationGroup::~QAnimationGroup()

Удаляет группу анимаций. Также удаляет все её анимации.

void QAnimationGroup::addAnimation(QAbstractAnimation *animation)

Добавляет animation в эту группу. Это вызовет insertAnimation с индексом, равным animationCount().

Примечание: группа принимает владение анимацией.

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

QAbstractAnimation *QAnimationGroup::animationAt(int index) const

Возвращает указатель на анимацию по индексу index в этой группе. Эта функция полезна, когда вам нужен доступ к определённой анимации. index находится в диапазоне от 0 до animationCount() - 1.

См. также animationCount() и indexOfAnimation().

int QAnimationGroup::animationCount() const

Возвращает количество анимаций, управляемых этой группой.

См. также indexOfAnimation(), addAnimation() и animationAt().

void QAnimationGroup::clear()

Удаляет и уничтожает все анимации в этой группе анимаций и сбрасывает текущее время до 0.

См. также addAnimation() и removeAnimation().

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

Переопределяет: QAbstractAnimation::event(QEvent *event).

int QAnimationGroup::indexOfAnimation(QAbstractAnimation *animation) const

Возвращает индекс animation. Возвращённый индекс может быть передан в другие функции, принимающие индекс в качестве аргумента.

См. также insertAnimation(), animationAt() и takeAnimation().

void QAnimationGroup::insertAnimation(int index, QAbstractAnimation *animation)

Вставляет animation в эту группу анимаций по индексу index. Если index равно 0, анимация вставляется в начало. Если index равно animationCount(), анимация вставляется в конец.

Примечание: группа принимает владение анимацией.

См. также takeAnimation(), addAnimation(), indexOfAnimation() и removeAnimation().

void QAnimationGroup::removeAnimation(QAbstractAnimation *animation)

Удаляет animation из этой группы. Владение animation передаётся вызывающему коду.

См. также takeAnimation(), insertAnimation() и addAnimation().

QAbstractAnimation *QAnimationGroup::takeAnimation(int index)

Возвращает анимацию по индексу index и удаляет её из группы анимаций.

Примечание: владение анимацией передаётся вызывающему коду.

См. также removeAnimation(), addAnimation(), insertAnimation() и indexOfAnimation().