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);
//...

Documentation des fonctions membres

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

Crée une chronologie d'une durée de duration millisecondes. L'objet ` parent ` est transmis au constructeur de ` QObject`. La durée par défaut est de 1 000 millisecondes.

[virtual noexcept] QTimeLine::~QTimeLine()

Détruit la chronologie.

int QTimeLine::currentFrame() const

Renvoie l'image correspondant à l'instant présent.

Voir également currentTime(), frameForTime() et setFrameRange().

qreal QTimeLine::currentValue() const

Renvoie la valeur correspondant à l'heure actuelle.

Voir également valueForTime() et currentFrame().

int QTimeLine::endFrame() const

Renvoie l'image de fin, c'est-à-dire l'image correspondant à la fin de la timeline (c'est-à-dire l'image pour laquelle la valeur actuelle est égale à 1).

Voir également setEndFrame() et setFrameRange().

[private signal] void QTimeLine::finished()

Ce signal est émis lorsque « QTimeLine » se termine (c'est-à-dire lorsqu'il atteint la fin de sa chronologie) et ne se répète pas en boucle.

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

QTimeLine émet ce signal à intervalles réguliers lorsqu'il est à l'Running, mais uniquement si la trame en cours change. frame correspond au numéro de la trame en cours.

Voir également QTimeLine::setFrameRange() et QTimeLine::updateInterval.

int QTimeLine::frameForTime(int msec) const

Renvoie l'image correspondant à l'instant msec. Cette valeur est calculée à l'aide d'une interpolation linéaire entre l'image de départ et l'image finale, sur la base de la valeur renvoyée par la fonction valueForTime().

Voir également valueForTime() et setFrameRange().

[slot] void QTimeLine::resume()

Reprend la chronologie à partir de l'heure actuelle. ` QTimeLine ` repasse à l'état « Running » et, dès qu'il entre dans la boucle d'événements, met à jour son heure, son image et sa valeur actuelles à intervalles réguliers.

Contrairement à la fonction start(), cette fonction ne redémarre pas la chronologie avant de la reprendre.

Voir également start(), updateInterval(), frameChanged() et valueChanged().

void QTimeLine::setEndFrame(int frame)

Définit l'image de fin, c'est-à-dire l'image correspondant à la fin de la timeline (c'est-à-dire l'image pour laquelle la valeur actuelle est 1), sur frame.

Voir également endFrame(), startFrame() et setFrameRange().

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

Définit le compteur d'images de la timeline pour qu'il commence à startFrame et se termine à endFrame. Pour chaque valeur temporelle, QTimeLine trouvera l'image correspondante lorsque vous appellerez currentFrame() ou frameForTime() par interpolation, en utilisant la valeur renvoyée par valueForTime().

Lorsqu’il est à l’état « Running », QTimeLine émet également le signal frameChanged() à chaque changement d’image.

Voir également startFrame(), endFrame(), start() et currentFrame().

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

Si paused est vrai, la timeline est mise en pause, ce qui fait passer QTimeLine à l’état « Paused ». Aucune mise à jour ne sera signalée tant que la méthode start() ou setPaused(false) n’aura pas été appelée. Si paused est faux, la timeline reprend et continue là où elle s’était arrêtée.

Voir également state() et start().

void QTimeLine::setStartFrame(int frame)

Définit l'image de départ, c'est-à-dire l'image correspondant au début de la timeline (c'est-à-dire l'image pour laquelle la valeur actuelle est 0), sur frame.

Voir également startFrame(), endFrame() et setFrameRange().

[slot] void QTimeLine::start()

Lance la timeline. ` QTimeLine ` passe à l'état « Running » et, une fois qu'elle entre dans la boucle d'événements, elle met à jour son heure, son image et sa valeur actuelles à intervalles réguliers. L'intervalle par défaut est de 40 ms (soit 25 fois par seconde). Vous pouvez modifier l'intervalle de mise à jour en appelant ` setUpdateInterval()`.

La timeline démarrera à la position 0, ou à la fin si le défilement s'effectue en arrière. Si vous souhaitez reprendre une timeline arrêtée sans la redémarrer, vous pouvez appeler resume() à la place.

Voir également resume(), updateInterval(), frameChanged() et valueChanged().

int QTimeLine::startFrame() const

Renvoie l'image de départ, c'est-à-dire l'image correspondant au début de la timeline (c'est-à-dire l'image pour laquelle la valeur actuelle est égale à 0).

Voir également setStartFrame() et setFrameRange().

QTimeLine::State QTimeLine::state() const

Renvoie l'état de la chronologie.

Voir également start(), setPaused() et stop().

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

Ce signal est émis chaque fois que l'état de ` QTimeLine` change. Le nouvel état est ` newState`.

[slot] void QTimeLine::stop()

Arrête la timeline, ce qui fait passer « QTimeLine » à l'état « NotRunning ».

Voir également start().

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

Réimplémente : QObject::timerEvent(QTimerEvent *event).

[slot] void QTimeLine::toggleDirection()

Permet de basculer entre les sens de la chronologie. Si le sens était « En avant », il passe à « En arrière », et inversement.

Les liaisons existantes de ` direction ` sont supprimées.

Voir aussi setDirection().

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

QTimeLine émet ce signal à intervalles réguliers lorsqu'il est à l'Running, mais uniquement si la valeur actuelle change. value correspond à la valeur actuelle. value est un nombre compris entre 0,0 et 1,0

Voir également QTimeLine::setDuration(), QTimeLine::valueForTime() et QTimeLine::updateInterval.

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

Renvoie la valeur de la timeline correspondant à l'msec. La valeur renvoyée, qui varie en fonction de la forme de la courbe, est toujours comprise entre 0 et 1. Si msec est égal à 0, l'implémentation par défaut renvoie toujours 0.

Réimplémentez cette fonction pour fournir une forme de courbe personnalisée à votre timeline.

Voir également easingCurve et frameForTime().