QMovie Class

QLabel label;
QMovie *movie = new QMovie("animations/fire.gif");

label.setMovie(movie);
movie->start();

QMovie movie("racecar.gif");
movie.setSpeed(200); // 2x speed

Dokumentation zu den Member-Funktionen

[explicit] QMovie::QMovie(QObject *parent = nullptr)

Erstellt ein QMovie-Objekt, indem das parent -Objekt an den Konstruktor von QObject übergeben wird.

Siehe auch „ setFileName()“, „ setDevice()“ und „ setFormat()“.

[explicit] QMovie::QMovie(QIODevice *device, const QByteArray &format = QByteArray(), QObject *parent = nullptr)

Erstellt ein QMovie-Objekt. QMovie verwendet die Bilddaten aus „ device “, von denen es annimmt, dass die Datei geöffnet und lesbar ist. Ist „ format “ nicht leer, verwendet QMovie das Bildformat „ format “ zum Dekodieren der Bilddaten. Andernfalls versucht QMovie, das Format zu ermitteln.

Das parent -Objekt wird an den Konstruktor von QObject übergeben.

[explicit] QMovie::QMovie(const QString &fileName, const QByteArray &format = QByteArray(), QObject *parent = nullptr)

Erstellt ein QMovie-Objekt. QMovie verwendet die aus fileName gelesenen Bilddaten. Ist format nicht leer, verwendet QMovie das Bildformat format zum Dekodieren der Bilddaten. Andernfalls versucht QMovie, das Format zu ermitteln.

Das Objekt ` parent ` wird an den Konstruktor von ` QObject` übergeben.

[virtual noexcept] QMovie::~QMovie()

Löscht das „ QMovie “-Objekt.

QColor QMovie::backgroundColor() const

Gibt die Hintergrundfarbe des Films zurück. Wenn keine Hintergrundfarbe zugewiesen wurde, wird ein ungültiger Wert vom Typ „ QColor “ zurückgegeben.

Siehe auch setBackgroundColor().

int QMovie::currentFrameNumber() const

Gibt die Sequenznummer des aktuellen Frames zurück. Die Nummer des ersten Frames im Film ist 0.

QImage QMovie::currentImage() const

Gibt den aktuellen Frame als ` QImage` zurück.

Siehe auch „ currentPixmap()“ und „ updated()“.

QPixmap QMovie::currentPixmap() const

Gibt den aktuellen Frame als „ QPixmap “ zurück.

Siehe auch „ currentImage()“ und „ updated()“.

QIODevice *QMovie::device() const

Gibt das Gerät zurück, von dem „ QMovie “ Bilddaten liest. Wenn derzeit kein Gerät zugewiesen ist, wird „ nullptr “ zurückgegeben.

Siehe auch ` setDevice()` und ` fileName()`.

[signal] void QMovie::error(QImageReader::ImageReaderError error)

Dieses Signal wird von QMovie ausgegeben, wenn während der Wiedergabe der Fehler „ error “ aufgetreten ist. QMovie stoppt den Film und wechselt in den Zustand „ QMovie::NotRunning “.

Siehe auch lastError() und lastErrorString().

QString QMovie::fileName() const

Gibt den Namen der Datei zurück, aus der QMovie Bilddaten liest. Wenn kein Dateiname zugewiesen wurde oder wenn das zugewiesene Gerät keine Datei ist, wird ein leeres QString zurückgegeben.

Siehe auch setFileName() und device().

[signal] void QMovie::finished()

Dieses Signal wird ausgegeben, wenn der Film zu Ende ist.

Siehe auch QMovie::stop().

QByteArray QMovie::format() const

Gibt das Format zurück, das „ QMovie “ beim Dekodieren von Bilddaten verwendet. Wenn kein Format zugewiesen wurde, wird ein leeres QByteArray() zurückgegeben.

Siehe auch setFormat().

[signal] void QMovie::frameChanged(int frameNumber)

Dieses Signal wird ausgelöst, wenn sich die Frame-Nummer auf „ frameNumber “ geändert hat. Sie können die Funktionen „ currentImage()“ oder „ currentPixmap()“ aufrufen, um eine Kopie des Frames abzurufen.

int QMovie::frameCount() const

Gibt die Anzahl der Frames im Film zurück.

Bestimmte Animationsformate unterstützen diese Funktion nicht; in diesem Fall wird 0 zurückgegeben.

QRect QMovie::frameRect() const

Gibt das Rechteck des letzten Frames zurück. Wenn noch kein Frame aktualisiert wurde, wird ein ungültiges ` QRect ` zurückgegeben.

Siehe auch ` currentImage()` und ` currentPixmap()`.

bool QMovie::isValid() const

Gibt „ true “ zurück, wenn der Film gültig ist (d. h. die Bilddaten sind lesbar und das Bildformat wird unterstützt); andernfalls wird „ false “ zurückgegeben.

Informationen darüber, warum der Film ungültig ist, finden Sie unter lastError().

bool QMovie::jumpToFrame(int frameNumber)

Springt zur Frame-Nummer frameNumber. Gibt bei Erfolg „ true “ zurück; andernfalls wird „ false “ zurückgegeben.

[slot] bool QMovie::jumpToNextFrame()

Springt zum nächsten Frame. Gibt bei Erfolg „ true “ zurück; andernfalls „ false “.

QImageReader::ImageReaderError QMovie::lastError() const

Gibt den zuletzt aufgetretenen Fehler beim Versuch, Bilddaten zu lesen, zurück.

Siehe auch „ lastErrorString()“.

QString QMovie::lastErrorString() const

Gibt eine für Menschen lesbare Darstellung des letzten Fehlers zurück, der beim Versuch, Bilddaten zu lesen, aufgetreten ist.

Siehe auch „ lastError()“.

int QMovie::loopCount() const

Gibt die Anzahl der Wiederholungen zurück, die der Film durchläuft, bevor er endet. Wenn der Film nur einmal abgespielt wird (keine Wiederholung), gibt `loopCount` den Wert 0 zurück. Wenn der Film endlos wiederholt wird, gibt `loopCount` den Wert -1 zurück.

Beachten Sie, dass „ QMovie “ den Film nur dann wiederholen kann, wenn die Bilddaten von einem sequenziellen Gerät (z. B. einem Socket) stammen und die Option „ cacheMode “ auf „ QMovie::CacheAll “ gesetzt ist.

int QMovie::nextFrameDelay() const

Gibt die Anzahl der Millisekunden zurück, die „ QMovie “ wartet, bevor das nächste Bild der Animation aktualisiert wird.

[signal] void QMovie::resized(const QSize &size)

Dieses Signal wird ausgelöst, wenn die Größe des aktuellen Frames auf size angepasst wurde. Dieser Effekt wird in Animationen manchmal als Alternative zum Ersetzen des Frames verwendet. Sie können currentImage() oder currentPixmap() aufrufen, um eine Kopie des aktualisierten Frames abzurufen.

QSize QMovie::scaledSize()

Gibt die skalierte Größe der Frames zurück.

Siehe auch setScaledSize() und QImageReader::scaledSize().

void QMovie::setBackgroundColor(const QColor &color)

Bei Bildformaten, die dies unterstützen, setzt diese Funktion die Hintergrundfarbe auf color.

Siehe auch backgroundColor().

void QMovie::setDevice(QIODevice *device)

Legt das aktuelle Gerät auf „ device “ fest. „ QMovie “ liest während der Wiedergabe des Films Bilddaten von diesem Gerät.

Siehe auch device() und setFormat().

void QMovie::setFileName(const QString &fileName)

Legt den Namen der Datei fest, aus der QMovie Bilddaten liest, auf fileName.

Siehe auch fileName(), setDevice() und setFormat().

void QMovie::setFormat(const QByteArray &format)

Legt das Format fest, das QMovie beim Dekodieren von Bilddaten verwenden soll: format. Standardmäßig versucht QMovie, das Format der Bilddaten zu ermitteln.

Sie können ` supportedFormats()` aufrufen, um eine vollständige Liste der von ` QMovie ` unterstützten Formate zu erhalten.

Siehe auch format() und QImageReader::supportedImageFormats().

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

Wenn „ paused “ wahr ist, wechselt „ QMovie “ in den Zustand „ Paused “ und gibt „ stateChanged “ (Paused) aus; andernfalls wechselt es in den Zustand „ Running “ und gibt „ stateChanged “ (Running) aus.

Siehe auch „ state()“.

void QMovie::setScaledSize(const QSize &size)

Legt die skalierte Rahmengröße auf „ size “ fest.

Siehe auch „ scaledSize()“ und „ QImageReader::setScaledSize()“.

[slot] void QMovie::start()

Startet den Film. „ QMovie “ wechselt in den Status „ Running “ und gibt im Verlauf des Films die Signale „ updated()“ und „ resized()“ aus.

Befindet sich „ QMovie “ im Zustand „ Paused “, entspricht diese Funktion dem Aufruf von „ setPaused(false)“. Befindet sich „ QMovie “ bereits im Zustand „ Running “, führt diese Funktion keine Aktion aus.

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

[signal] void QMovie::started()

Dieses Signal wird ausgelöst, nachdem „ QMovie::start()“ aufgerufen wurde und „ QMovie “ in den Zustand „ QMovie::Running “ übergegangen ist.

QMovie::MovieState QMovie::state() const

Gibt den aktuellen Status von „ QMovie “ zurück.

Siehe auch „ MovieState “ und „ stateChanged()“.

[signal] void QMovie::stateChanged(QMovie::MovieState state)

Dieses Signal wird jedes Mal ausgelöst, wenn sich der Status des Films ändert. Der neue Status wird durch „ state “ festgelegt.

Siehe auch ` QMovie::state()`.

[slot] void QMovie::stop()

Hält den Film an. „ QMovie “ wechselt in den Status „ NotRunning “ und gibt die Ereignisse „ updated()“ und „ resized()“ nicht mehr aus. Wird „ start()“ erneut aufgerufen, wird der Film von Anfang an neu gestartet.

Befindet sich QMovie bereits im Zustand „ NotRunning “, führt diese Funktion keine Aktion aus.

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

[static] QList<QByteArray> QMovie::supportedFormats()

Gibt die Liste der von QMovie unterstützten Bildformate zurück.

Siehe auch QImageReader::supportedImageFormats().

[signal] void QMovie::updated(const QRect &rect)

Dieses Signal wird ausgelöst, wenn die Rect- rect e im aktuellen Frame aktualisiert wurde. Sie können die Funktionen „ currentImage()“ oder „ currentPixmap()“ aufrufen, um eine Kopie des aktualisierten Frames abzurufen.