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

Dokumentation zu den Mitgliedsfunktionen

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

Erstellt 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 Zeitleiste.

int QTimeLine::currentFrame() const

Gibt den Frame zurück, der dem aktuellen Zeitpunkt entspricht.

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

qreal QTimeLine::currentValue() const

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

Siehe auch valueForTime() und currentFrame().

int QTimeLine::endFrame() const

Gibt das Endbild zurück, d. h. das Bild, das dem Ende der Zeitachse entspricht (d. h. das Bild, 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 seiner Zeitleiste erreicht hat), und wird nicht wiederholt.

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

QTimeLine sendet dieses Signal im Zustand „ Running “ in regelmäßigen Abständen, jedoch 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 dem Zeit msec entspricht. Dieser Wert wird anhand einer linearen Interpolation des Start- und End-Frames berechnet, basierend auf dem von valueForTime() zurückgegebenen Wert.

Siehe auch valueForTime() und setFrameRange().

[slot] void QTimeLine::resume()

Setzt die Zeitleiste ab dem aktuellen Zeitpunkt fort. „ QTimeLine “ wechselt wieder in den Status „Running“ und aktualisiert, sobald es in die Ereignisschleife eintritt, in regelmäßigen Abständen die aktuelle Zeit, den Frame und den Wert.

Im Gegensatz zu ` start()` startet diese Funktion die Zeitleiste vor der Fortsetzung nicht neu.

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

void QTimeLine::setEndFrame(int frame)

Setzt den Endframe – also 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 Frame-Zähler der Zeitleiste so, dass er bei startFrame beginnt und bei endFrame endet. Für jeden Zeitwert ermittelt QTimeLine den entsprechenden Frame, wenn Sie currentFrame() oder frameForTime() aufrufen, und zwar durch Interpolation unter Verwendung des Rückgabewerts von valueForTime().

Im Status „Running“ sendet QTimeLine außerdem das Signal „ frameChanged()“, wenn sich der Frame ä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 Status „Paused“ wechselt. Es werden keine Aktualisierungen gemeldet, bis entweder „ start()“ oder „setPaused(false)“ aufgerufen wird. Wenn „ paused “ falsch ist, wird die Zeitleiste fortgesetzt und läuft dort weiter, wo sie unterbrochen wurde.

Siehe auch „ state()“ und „ start()“.

void QTimeLine::setStartFrame(int frame)

Setzt den Startframe – also den Frame, der dem Anfang 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 “ wechselt in den Status „Running“ und aktualisiert, sobald es in die Ereignisschleife eintritt, 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 bei Position 0 oder, bei Rücklauf, am Ende. Wenn Sie eine angehaltene Zeitleiste fortsetzen möchten, ohne sie neu zu starten, können Sie stattdessen resume() aufrufen.

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

int QTimeLine::startFrame() const

Gibt den Start-Frame zurück, d. h. den Frame, der dem Anfang der Zeitleiste entspricht (d. h. den Frame, für den der aktuelle Wert 0 ist).

Siehe auch setStartFrame() und setFrameRange().

QTimeLine::State QTimeLine::state() const

Gibt den Status der Zeitleiste zurück.

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

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

Dieses Signal wird immer dann ausgelöst, 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 Status „ NotRunning “ wechselt.

Siehe auch start().

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

Implementiert: ` QObject::timerEvent(QTimerEvent *event)`.

[slot] void QTimeLine::toggleDirection()

Schaltet die Richtung der Zeitleiste um. Wenn die Richtung „Vorwärts“ war, wird sie zu „Rückwärts“ und umgekehrt.

Bestehende Zuordnungen von „ direction “ werden entfernt.

Siehe auch „ setDirection()“.

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

QTimeLine sendet dieses Signal in regelmäßigen Abständen, wenn es sich im Zustand „ Running “ befindet, jedoch 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 Zeitachsenwert für den Zeit msec zurück. Der zurückgegebene Wert, der je nach Kurvenform variiert, liegt immer zwischen 0 und 1. Wenn msec gleich 0 ist, gibt die Standardimplementierung immer 0 zurück.

Implementieren Sie diese Funktion neu, um eine benutzerdefinierte Kurvenform für Ihre Zeitleiste bereitzustellen.

Siehe auch ` easingCurve ` und ` frameForTime()`.