Класс QAnimationGroup
Класс QAnimationGroup является абстрактным базовым классом для групп анимаций. Подробнее...
| Заголовок: | #include <QAnimationGroup> |
| CMake: | find_package(Qt6 COMPONENTS Core REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
| Наследуется от: | QAbstractAnimation |
| Наследуется: |
Открытые функции
| QAnimationGroup(QObject *parent = nullptr) | |
| virtual | ~QAnimationGroup() |
| void | addAnimation(QAbstractAnimation *animation) |
| QAbstractAnimation * | animationAt(int index) const |
| int | animationCount() const |
| void | clear() |
| int | indexOfAnimation(QAbstractAnimation *animation) const |
| void | insertAnimation(int index, QAbstractAnimation *animation) |
| void | removeAnimation(QAbstractAnimation *animation) |
| QAbstractAnimation * | takeAnimation(int index) |
Переопределенные защищенные функции
| virtual bool | event(QEvent *event) override |
Подробное описание
Группа анимаций — это контейнер для анимаций (подклассы QAbstractAnimation). Группа обычно отвечает за управление состоянием своих анимаций, т. е. она решает, когда их запускать, останавливать, возобновлять и приостанавливать. В настоящее время Qt предоставляет две такие группы: QParallelAnimationGroup и QSequentialAnimationGroup. Подробности см. в описаниях их классов.
Поскольку QAnimationGroup наследуется от QAbstractAnimation, вы можете комбинировать группы и легко создавать сложные графики анимаций. Вы можете запросить QAbstractAnimation о группе, к которой она принадлежит (используя функцию group() ).
Чтобы запустить группу анимаций верхнего уровня, просто используйте функцию start() из QAbstractAnimation. Под группой верхнего уровня мы подразумеваем группу, которая сама не содержится в другой группе. Прямой запуск дочерних групп не поддерживается и может привести к неожиданному поведению.
QAnimationGroup предоставляет методы для добавления и извлечения анимаций. Кроме того, вы можете удалить анимации, вызвав removeAnimation(), и очистить группу анимаций, вызвав clear(). Вы можете отслеживать изменения в анимациях группы, прослушивая события QEvent::ChildAdded и QEvent::ChildRemoved.
QAnimationGroup принимает на себя управление анимациями, которые он управляет, и гарантирует, что они будут удалены при удалении группы анимаций.
См. также QAbstractAnimation, QVariantAnimation и The Animation Framework.
Документация по функциям-членам
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().
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.2/qanimationgroup.html