QTimeLine Class

//...
auto progressBar = new QProgressBar(this);
progressBar->setRange(0, 100);

// Construct a 1-second timeline with a frame range of 0 - 100
QTimeLine *timeLine = new QTimeLine(1000, this);
timeLine->setFrameRange(0, 100);
connect(timeLine, &QTimeLine::frameChanged, progressBar, &QProgressBar::setValue);

// Clicking the push button will start the progress bar animation
auto pushButton = new QPushButton(tr("Start animation"), this);
connect(pushButton, &QPushButton::clicked, timeLine, &QTimeLine::start);
//...

Documentación de las funciones miembro

[explicit] QTimeLine::QTimeLine(int duration = 1000, QObject *parent = nullptr)

Construye una línea de tiempo con una duración de duration milisegundos. parent se pasa al constructor de QObject. La duración por defecto es de 1000 milisegundos.

[virtual noexcept] QTimeLine::~QTimeLine()

Destruye la línea temporal.

int QTimeLine::currentFrame() const

Devuelve el fotograma correspondiente a la hora actual.

Véase también currentTime(), frameForTime() y setFrameRange().

qreal QTimeLine::currentValue() const

Devuelve el valor correspondiente a la hora actual.

Véase también valueForTime() y currentFrame().

int QTimeLine::endFrame() const

Devuelve el fotograma final, que es el fotograma correspondiente al final de la línea de tiempo (es decir, el fotograma para el que el valor actual es 1).

Véase también setEndFrame() y setFrameRange().

[private signal] void QTimeLine::finished()

Esta señal se emite cuando QTimeLine termina (es decir, alcanza el final de su línea de tiempo), y no hace un bucle.

[private signal] void QTimeLine::frameChanged(int frame)

QTimeLine emite esta señal a intervalos regulares cuando está en estado Running, pero sólo si cambia el fotograma actual. frame es el número de fotograma actual.

Véase también QTimeLine::setFrameRange() y QTimeLine::updateInterval.

int QTimeLine::frameForTime(int msec) const

Devuelve el fotograma correspondiente al tiempo msec. Este valor se calcula utilizando una interpolación lineal del fotograma inicial y final, basada en el valor devuelto por valueForTime().

Véase también valueForTime() y setFrameRange().

[slot] void QTimeLine::resume()

Reanuda la línea de tiempo desde el tiempo actual. QTimeLine volverá a entrar en estado de ejecución, y una vez que entre en el bucle de eventos, actualizará su tiempo actual, fotograma y valor a intervalos regulares.

A diferencia de start(), esta función no reinicia la línea de tiempo antes de reanudarla.

Véase también start(), updateInterval(), frameChanged(), y valueChanged().

void QTimeLine::setEndFrame(int frame)

Establece el fotograma final, que es el fotograma correspondiente al final de la línea de tiempo (es decir, el fotograma para el que el valor actual es 1), en frame.

Véase también endFrame(), startFrame() y setFrameRange().

void QTimeLine::setFrameRange(int startFrame, int endFrame)

Establece el contador de fotogramas de la línea de tiempo para que comience en startFrame, y termine y endFrame. Para cada valor de tiempo, QTimeLine encontrará el fotograma correspondiente cuando llame a currentFrame() o frameForTime() interpolando, utilizando el valor de retorno de valueForTime().

En estado de ejecución, QTimeLine también emite la señal frameChanged() cuando cambia el fotograma.

Véase también startFrame(), endFrame(), start(), y currentFrame().

[slot] void QTimeLine::setPaused(bool paused)

Si paused es verdadero, la línea de tiempo se pausa, causando que QTimeLine entre en estado Pausado. No se señalarán actualizaciones hasta que se llame a start() o a setPaused(false). Si paused es falso, la línea de tiempo se reanuda y continúa donde se quedó.

Véase también state() y start().

void QTimeLine::setStartFrame(int frame)

Establece el fotograma de inicio, que es el fotograma correspondiente al inicio de la línea de tiempo (es decir, el fotograma para el que el valor actual es 0), en frame.

Véase también startFrame(), endFrame() y setFrameRange().

[slot] void QTimeLine::start()

Inicia la línea de tiempo. QTimeLine entrará en estado Ejecutando, y una vez que entre en el bucle de eventos, actualizará su tiempo actual, fotograma y valor a intervalos regulares. El intervalo por defecto es de 40 ms (es decir, 25 veces por segundo). Puede cambiar el intervalo de actualización llamando a setUpdateInterval().

La línea de tiempo comenzará desde la posición 0, o desde el final si se va hacia atrás. Si desea reanudar una línea de tiempo detenida sin reiniciarla, puede llamar a resume() en su lugar.

Véase también resume(), updateInterval(), frameChanged() y valueChanged().

int QTimeLine::startFrame() const

Devuelve el fotograma de inicio, que es el fotograma correspondiente al inicio de la línea de tiempo (es decir, el fotograma para el que el valor actual es 0).

Véase también setStartFrame() y setFrameRange().

QTimeLine::State QTimeLine::state() const

Devuelve el estado de la línea de tiempo.

Véase también start(), setPaused() y stop().

[private signal] void QTimeLine::stateChanged(QTimeLine::State newState)

Esta señal se emite cada vez que cambia el estado de QTimeLine. El nuevo estado es newState.

[slot] void QTimeLine::stop()

Detiene la línea de tiempo, haciendo que QTimeLine entre en estado NotRunning.

Véase también start().

[override virtual protected] void QTimeLine::timerEvent(QTimerEvent *event)

Reimplementa: QObject::timerEvent(QTimerEvent *event).

[slot] void QTimeLine::toggleDirection()

Cambia la dirección de la línea de tiempo. Si la dirección era Adelante, se convierte en Atrás, y vice verca.

Se eliminan las vinculaciones existentes de direction.

Véase también setDirection().

[private signal] void QTimeLine::valueChanged(qreal value)

QTimeLine emite esta señal a intervalos regulares cuando está en estado Running, pero sólo si cambia el valor actual. value es el valor actual. value es un número entre 0.0 y 1.0

Véase también QTimeLine::setDuration(), QTimeLine::valueForTime(), y QTimeLine::updateInterval.

[virtual] qreal QTimeLine::valueForTime(int msec) const

Devuelve el valor de la línea de tiempo para el tiempo msec. El valor devuelto, que varía dependiendo de la forma de la curva, está siempre entre 0 y 1. Si msec es 0, la implementación por defecto siempre devuelve 0.

Reimplemente esta función para proporcionar una forma de curva personalizada para su línea de tiempo.

Véase también easingCurve y frameForTime().