QVariantAnimation Class

     QVariant myColorInterpolator(const QColor &start, const QColor &end, qreal progress)
     {
         ...
         return QColor(...);
     }
     ...
     qRegisterAnimationInterpolator<QColor>(myColorInterpolator);

Member Function Documentation

QVariantAnimation::QVariantAnimation(QObject *parent = nullptr)

Construct a QVariantAnimation object. parent is passed to QAbstractAnimation's constructor.

[virtual noexcept] QVariantAnimation::~QVariantAnimation()

Destroys the animation.

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

Reimplements: QAbstractAnimation::event(QEvent *event).

[virtual protected] QVariant QVariantAnimation::interpolated(const QVariant &from, const QVariant &to, qreal progress) const

This virtual function returns the linear interpolation between variants from and to, at progress, usually a value between 0 and 1. You can reimplement this function in a subclass of QVariantAnimation to provide your own interpolation algorithm.

Note that in order for the interpolation to work with a QEasingCurve that return a value smaller than 0 or larger than 1 (such as QEasingCurve::InBack) you should make sure that it can extrapolate. If the semantic of the datatype does not allow extrapolation this function should handle that gracefully.

You should call the QVariantAnimation implementation of this function if you want your class to handle the types already supported by Qt (see class QVariantAnimation description for a list of supported types).

See also QEasingCurve.

QVariant QVariantAnimation::keyValueAt(qreal step) const

Returns the key frame value for the given step. The given step must be in the range 0 to 1. If there is no KeyValue for step, it returns an invalid QVariant.

See also keyValues() and setKeyValueAt().

QVariantAnimation::KeyValues QVariantAnimation::keyValues() const

Returns the key frames of this animation.

See also keyValueAt() and setKeyValues().

void QVariantAnimation::setKeyValueAt(qreal step, const QVariant &value)

Creates a key frame at the given step with the given value. The given step must be in the range 0 to 1.

See also setKeyValues() and keyValueAt().

void QVariantAnimation::setKeyValues(const QVariantAnimation::KeyValues &keyValues)

Replaces the current set of key frames with the given keyValues. the step of the key frames must be in the range 0 to 1.

See also keyValues() and keyValueAt().

[override virtual protected] void QVariantAnimation::updateCurrentTime(int)

Reimplements: QAbstractAnimation::updateCurrentTime(int currentTime).

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

This virtual function is called every time the animation's current value changes. The value argument is the new current value.

The base class implementation does nothing.

See also currentValue.

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

Reimplements: QAbstractAnimation::updateState(QAbstractAnimation::State newState, QAbstractAnimation::State oldState).

[signal] void QVariantAnimation::valueChanged(const QVariant &value)

QVariantAnimation emits this signal whenever the current value changes.

See also currentValue, startValue, and endValue.