Класс QPropertyAnimation

Класс QPropertyAnimation анимирует свойства Qt. Подробнее...

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

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

Свойства

• propertyName : QByteArray
• targetObject : QObject*

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

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

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

QPropertyAnimation интерполирует по свойствам Qt. Поскольку значения свойств хранятся в QVariant, класс наследует QVariantAnimation и поддерживает анимацию тех же метатипов, что и его родительский класс.

Класс, объявляющий свойства, должен быть QObject. Чтобы можно было анимировать свойство, оно должно предоставлять сеттер (так, чтобы QPropertyAnimation мог установить значение свойства). Обратите внимание, что это позволяет анимировать многие виджеты Qt. Давайте посмотрим на пример:

    QPropertyAnimation *animation = new QPropertyAnimation(myWidget, "geometry");
    animation->setDuration(10000);
    animation->setStartValue(QRect(0, 0, 100, 30));
    animation->setEndValue(QRect(250, 250, 100, 30));

    animation->start();

Имя свойства и экземпляр QObject, свойство которого необходимо анимировать, передаются в конструктор. Затем можно указать начальное и конечное значение свойства. Процедура аналогична для свойств в классах, которые вы реализовали сами — просто убедитесь с помощью QVariantAnimation, что ваш тип QVariant поддерживается.

Описание класса QVariantAnimation подробно объясняет, как настроить анимацию. Однако, если начальное значение не задано, свойство будет начинаться со значения, которое оно имело при создании экземпляра QPropertyAnimation.

QPropertyAnimation работает отлично сам по себе. Для сложных анимаций, которые, например, содержат несколько объектов, предоставляется QAnimationGroup. Группа анимаций — это анимация, которая может содержать другие анимации и управлять их воспроизведением. Посмотрите на QParallelAnimationGroup для примера.

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

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

QPropertyAnimation::QPropertyAnimation(QObject *target, const QByteArray &propertyName, QObject *parent = nullptr)

Создает объект QPropertyAnimation. parent передается в конструктор QObject. Анимация изменяет свойство propertyName на target. Продолжительность по умолчанию — 250 мс.

См. также targetObject и propertyName.

QPropertyAnimation::QPropertyAnimation(QObject *parent = nullptr)

Создает объект QPropertyAnimation. parent передается в конструктор QObject.

[virtual] QPropertyAnimation::~QPropertyAnimation()

Уничтожает экземпляр QPropertyAnimation.

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

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

[override virtual protected] void QPropertyAnimation::updateCurrentValue(const QVariant &value)

Переопределяет: QVariantAnimation::updateCurrentValue(const QVariant &value).

Эта виртуальная функция вызывается QVariantAnimation всякий раз, когда изменяется текущее значение. value — новое обновленное значение. Она обновляет текущее значение свойства в целевом объекте.

См. также currentValue и currentTime.

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

Переопределяет: QVariantAnimation::updateState(QAbstractAnimation::State newState, QAbstractAnimation::State oldState).

Если startValue не определено при изменении состояния анимации с Stopped на Running, текущее значение свойства используется в качестве начального значения для анимации.