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)

Construit une ligne de temps d'une durée de duration millisecondes. parent est transmis au constructeur de QObject. La durée par défaut est de 1000 millisecondes.

[virtual noexcept] QTimeLine::~QTimeLine()

Détruit la ligne temporelle.

int QTimeLine::currentFrame() const

Renvoie la trame correspondant à l'heure actuelle.

Voir aussi currentTime(), frameForTime() et setFrameRange().

qreal QTimeLine::currentValue() const

Renvoie la valeur correspondant à l'heure actuelle.

Voir aussi valueForTime() et currentFrame().

int QTimeLine::endFrame() const

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

Voir également setEndFrame() et setFrameRange().

[private signal] void QTimeLine::finished()

Ce signal est émis lorsque QTimeLine se termine (c'est-à-dire qu'il atteint la fin de sa ligne temporelle), et ne boucle pas.

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

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

Voir aussi QTimeLine::setFrameRange() et QTimeLine::updateInterval.

int QTimeLine::frameForTime(int msec) const

Renvoie la trame correspondant au temps msec. Cette valeur est calculée à l'aide d'une interpolation linéaire des images de début et de fin, sur la base de la valeur renvoyée par valueForTime().

Voir aussi valueForTime() et setFrameRange().

[slot] void QTimeLine::resume()

Reprend la ligne de temps à partir de l'heure actuelle. QTimeLine réintègre l'état Running et, une fois qu'il entre dans la boucle événementielle, il met à jour l'heure, la trame et la valeur à intervalles réguliers.

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

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

void QTimeLine::setEndFrame(int frame)

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

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

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

Définit le compteur d'images de la ligne de temps 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 de retour de valueForTime().

Lorsqu'il est en état de fonctionnement, QTimeLine émet également le signal frameChanged() lorsque la trame change.

Voir aussi startFrame(), endFrame(), start() et currentFrame().

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

Si paused est vrai, la ligne de temps est mise en pause, ce qui entraîne l'entrée de QTimeLine dans l'état Paused. Aucune mise à jour ne sera signalée jusqu'à ce que start() ou setPaused(false) soit appelé. Si paused est faux, la ligne de temps est reprise et continue là où elle s'est arrêtée.

Voir aussi state() et start().

void QTimeLine::setStartFrame(int frame)

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

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

[slot] void QTimeLine::start()

Lance la ligne de temps. QTimeLine entre dans l'état "Running" et, une fois qu'il entre dans la boucle d'événements, il met à jour l'heure, la trame et la valeur à 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 ligne temporelle commence à la position 0, ou à la fin si l'on revient en arrière. Si vous souhaitez reprendre une ligne temporelle arrêtée sans la redémarrer, vous pouvez appeler resume() à la place.

Voir aussi 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 ligne de temps (c'est-à-dire l'image pour laquelle la valeur actuelle est 0).

Voir également setStartFrame() et setFrameRange().

QTimeLine::State QTimeLine::state() const

Renvoie l'état de la ligne de temps.

Voir aussi start(), setPaused(), et stop().

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

Ce signal est émis lorsque l'état de QTimeLine change. Le nouvel état est newState.

[slot] void QTimeLine::stop()

Arrête la ligne de temps, faisant passer QTimeLine à l'état NotRunning.

Voir aussi start().

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

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

[slot] void QTimeLine::toggleDirection()

Change la direction de la ligne de temps. Si la direction était Forward, elle devient Backward, et vice versa.

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 dans l'état Running, mais seulement si la valeur actuelle change. value est la valeur actuelle. value est un nombre entre 0.0 et 1.0

Voir aussi QTimeLine::setDuration(), QTimeLine::valueForTime() et QTimeLine::updateInterval.

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

Renvoie la valeur de la ligne de temps pour le temps 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 0, l'implémentation par défaut renvoie toujours 0.

Réimplémentez cette fonction pour obtenir une forme de courbe personnalisée pour votre ligne de temps.

Voir également easingCurve et frameForTime().