QTimeLine Class

...
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
pushButton = new QPushButton(tr("Start animation"), this);
connect(pushButton, &QPushButton::clicked, timeLine, &QTimeLine::start);
...

Dokumentation der Mitgliedsfunktionen

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

Konstruiert eine Zeitleiste mit einer Dauer von duration Millisekunden. parent wird an den Konstruktor von QObject übergeben. Die Standarddauer beträgt 1000 Millisekunden.

[virtual noexcept] QTimeLine::~QTimeLine()

Zerstört die Zeitlinie.

int QTimeLine::currentFrame() const

Gibt den Frame zurück, der der aktuellen Zeit entspricht.

Siehe auch currentTime(), frameForTime(), und setFrameRange().

qreal QTimeLine::currentValue() const

Gibt den Wert zurück, der der aktuellen Zeit entspricht.

Siehe auch valueForTime() und currentFrame().

int QTimeLine::endFrame() const

Gibt das Endframe zurück, d. h. das Frame, das dem Ende der Zeitleiste entspricht (d. h. das Frame, für das der aktuelle Wert 1 ist).

Siehe auch setEndFrame() und setFrameRange().

[private signal] void QTimeLine::finished()

Dieses Signal wird ausgegeben, wenn QTimeLine beendet ist (d.h. das Ende der Zeitleiste erreicht), und läuft nicht in einer Schleife.

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

QTimeLine sendet dieses Signal in regelmäßigen Abständen, wenn es sich im Zustand Running befindet, aber nur, wenn sich der aktuelle Frame ändert. frame ist die aktuelle Frame-Nummer.

Siehe auch QTimeLine::setFrameRange() und QTimeLine::updateInterval.

int QTimeLine::frameForTime(int msec) const

Gibt den Frame zurück, der der Zeit msec entspricht. Dieser Wert wird durch eine lineare Interpolation des Start- und Endbildes auf der Grundlage des von valueForTime() zurückgegebenen Wertes berechnet.

Siehe auch valueForTime() und setFrameRange().

[slot] void QTimeLine::resume()

Setzt die Zeitleiste ab der aktuellen Zeit fort. QTimeLine tritt wieder in den Zustand "Running" ein, und sobald es in die Ereignisschleife eintritt, aktualisiert es in regelmäßigen Abständen die aktuelle Zeit, das Bild und den Wert.

Im Gegensatz zu start() startet diese Funktion die Zeitleiste nicht neu, bevor sie fortgesetzt wird.

Siehe auch start(), updateInterval(), frameChanged(), und valueChanged().

void QTimeLine::setEndFrame(int frame)

Setzt den End-Frame, d.h. den Frame, der dem Ende der Zeitleiste entspricht (d.h. den Frame, für den der aktuelle Wert 1 ist), auf frame.

Siehe auch endFrame(), startFrame(), und setFrameRange().

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

Setzt den Bildzähler der Zeitleiste so, dass er bei startFrame beginnt und bei endFrame endet. Für jeden Zeitwert findet QTimeLine das entsprechende Bild, wenn Sie currentFrame() oder frameForTime() aufrufen, indem es interpoliert und den Rückgabewert von valueForTime() verwendet.

Im Zustand "Running" gibt QTimeLine auch das Signal frameChanged() aus, wenn sich der Rahmen ändert.

Siehe auch startFrame(), endFrame(), start(), und currentFrame().

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

Wenn paused wahr ist, wird die Zeitleiste angehalten, wodurch QTimeLine in den Pausenzustand übergeht. Es werden keine Aktualisierungen signalisiert, bis entweder start() oder setPaused(false) aufgerufen wird. Wenn paused falsch ist, wird die Zeitleiste wieder aufgenommen und macht dort weiter, wo sie aufgehört hat.

Siehe auch state() und start().

void QTimeLine::setStartFrame(int frame)

Setzt den Start-Frame, d.h. den Frame, der dem Beginn der Zeitleiste entspricht (d.h. den Frame, für den der aktuelle Wert 0 ist), auf frame.

Siehe auch startFrame(), endFrame(), und setFrameRange().

[slot] void QTimeLine::start()

Startet die Zeitleiste. QTimeLine geht in den Status "Laufend" über und aktualisiert nach Eintritt in die Ereignisschleife in regelmäßigen Abständen die aktuelle Zeit, den Frame und den Wert. Das Standardintervall beträgt 40 ms (d. h. 25 Mal pro Sekunde). Sie können das Aktualisierungsintervall ändern, indem Sie setUpdateInterval() aufrufen.

Die Zeitleiste beginnt an der Position 0 bzw. am Ende, wenn sie rückwärts läuft. Wenn Sie eine angehaltene Zeitleiste ohne Neustart wieder aufnehmen möchten, können Sie stattdessen resume() aufrufen.

Siehe auch resume(), updateInterval(), frameChanged(), und valueChanged().

int QTimeLine::startFrame() const

Gibt das Startbild zurück, d. h. das Bild, das dem Beginn der Zeitleiste entspricht (d. h. das Bild, für das der aktuelle Wert 0 ist).

Siehe auch setStartFrame() und setFrameRange().

QTimeLine::State QTimeLine::state() const

Gibt den Zustand der Zeitleiste zurück.

Siehe auch start(), setPaused(), und stop().

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

Dieses Signal wird ausgegeben, wenn sich der Zustand von QTimeLine ändert. Der neue Zustand ist newState.

[slot] void QTimeLine::stop()

Hält die Zeitleiste an, wodurch QTimeLine in den Zustand NotRunning wechselt.

Siehe auch start().

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

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

[slot] void QTimeLine::toggleDirection()

Schaltet die Richtung der Zeitleiste um. Wenn die Richtung vorwärts war, wird sie rückwärts und umgekehrt.

Vorhandene Bindungen von direction werden entfernt.

Siehe auch setDirection().

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

QTimeLine sendet dieses Signal in regelmäßigen Abständen im Zustand Running, aber nur, wenn sich der aktuelle Wert ändert. value ist der aktuelle Wert. value ist eine Zahl zwischen 0,0 und 1,0

Siehe auch QTimeLine::setDuration(), QTimeLine::valueForTime(), und QTimeLine::updateInterval.

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

Gibt den Zeitleistenwert für die Zeit msec zurück. Der zurückgegebene Wert, der je nach Kurvenform variiert, liegt immer zwischen 0 und 1. Wenn msec 0 ist, gibt die Standardimplementierung immer 0 zurück.

Reimplementieren Sie diese Funktion, um eine benutzerdefinierte Kurvenform für Ihre Zeitleiste zu erstellen.

Siehe auch easingCurve und frameForTime().