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 der Mitgliedsfunktionen

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

Konstruiert ein QMovie-Objekt und übergibt das Objekt parent an den Konstruktor von QObject.

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

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

Konstruiert ein QMovie-Objekt. QMovie verwendet gelesene Bilddaten aus device, von denen es annimmt, dass sie offen und lesbar sind. Wenn format nicht leer ist, verwendet QMovie das Bildformat format zur Dekodierung der Bilddaten. Andernfalls versucht QMovie, das Format zu erraten.

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

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

Konstruiert ein QMovie-Objekt. QMovie verwendet gelesene Bilddaten aus fileName. Wenn format nicht leer ist, verwendet QMovie das Bildformat format zur Dekodierung der Bilddaten. Andernfalls versucht QMovie, das Format zu erraten.

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

[virtual noexcept] QMovie::~QMovie()

Zerstört das Objekt QMovie.

QColor QMovie::backgroundColor() const

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

Siehe auch setBackgroundColor().

int QMovie::currentFrameNumber() const

Gibt die Sequenznummer des aktuellen Bildes zurück. Die Nummer des ersten Bildes 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 auftritt. QMovie hält den Film an und geht in den Zustand QMovie::NotRunning über.

Siehe auch lastError() und lastErrorString().

QString QMovie::fileName() const

Gibt den Namen der Datei zurück, aus der QMovie die 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 ausgesendet, wenn der Film beendet ist.

Siehe auch QMovie::stop().

QByteArray QMovie::format() const

Gibt das Format zurück, das QMovie bei der Dekodierung von Bilddaten verwendet. Wurde kein Format zugewiesen, wird ein leeres QByteArray() zurückgegeben.

Siehe auch setFormat().

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

Dieses Signal wird ausgegeben, wenn sich die Rahmennummer zu frameNumber geändert hat. Sie können currentImage() oder currentPixmap() aufrufen, um eine Kopie des Rahmens zu erhalten.

int QMovie::frameCount() const

Gibt die Anzahl der Bilder im Film zurück.

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

QRect QMovie::frameRect() const

Gibt das Rect des letzten Frames zurück. Wenn noch kein Rahmen aktualisiert wurde, wird ein ungültiger QRect zurückgegeben.

Siehe auch currentImage() und currentPixmap().

bool QMovie::isValid() const

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

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

bool QMovie::jumpToFrame(int frameNumber)

Springt zur Frame-Nummer frameNumber. Gibt bei Erfolg true zurück, andernfalls false.

[slot] bool QMovie::jumpToNextFrame()

Springt zum nächsten Frame. Gibt bei Erfolg true zurück, ansonsten false.

QImageReader::ImageReaderError QMovie::lastError() const

Gibt den letzten Fehler zurück, der beim Versuch, Bilddaten zu lesen, aufgetreten ist.

Siehe auch lastErrorString().

QString QMovie::lastErrorString() const

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

Siehe auch lastError().

int QMovie::loopCount() const

Gibt an, wie oft der Film in einer Schleife abgespielt wird, bevor er zu Ende ist. Wenn der Film nur einmal abgespielt wird (keine Schleife), gibt loopCount 0 zurück. Wenn der Film in einer Endlosschleife läuft, gibt loopCount -1 zurück.

Wenn die Bilddaten von einem sequenziellen Gerät (z. B. einem Socket) stammen, kann QMovie den Film nur dann in einer Schleife abspielen, wenn 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 in der Animation aktualisiert wird.

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

Dieses Signal wird ausgegeben, wenn die Größe des aktuellen Rahmens auf size geändert wurde. Dieser Effekt wird manchmal in Animationen als Alternative zum Ersetzen des Rahmens verwendet. Sie können currentImage() oder currentPixmap() aufrufen, um eine Kopie des aktualisierten Rahmens zu erhalten.

QSize QMovie::scaledSize()

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

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

void QMovie::setBackgroundColor(const QColor &color)

Für Bildformate, die dies unterstützen, setzt diese Funktion die Hintergrundfarbe auf color.

Siehe auch backgroundColor().

void QMovie::setDevice(QIODevice *device)

Setzt das aktuelle Gerät auf device. QMovie liest Bilddaten von diesem Gerät, wenn der Film läuft.

Siehe auch device() und setFormat().

void QMovie::setFileName(const QString &fileName)

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

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

void QMovie::setFormat(const QByteArray &format)

Setzt das Format, das QMovie bei der Dekodierung von Bilddaten verwendet, auf format. Standardmäßig versucht QMovie, das Format der Bilddaten zu erraten.

Sie können supportedFormats() aufrufen, um die vollständige Liste der Formate zu erhalten, die QMovie unterstützt.

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

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

Wenn paused wahr ist, geht QMovie in den Zustand Paused über und sendet stateChanged(Paused); andernfalls geht es in den Zustand Running über und sendet stateChanged(Running).

Siehe auch state().

void QMovie::setScaledSize(const QSize &size)

Setzt die skalierte Rahmengröße auf size.

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

[slot] void QMovie::start()

Startet den Film. QMovie geht in den Zustand Running über und beginnt mit der Ausgabe von updated() und resized(), wenn der Film fortschreitet.

Wenn sich QMovie im Zustand Paused befindet, ist diese Funktion gleichbedeutend mit dem Aufruf von setPaused(false). Wenn sich QMovie bereits im Zustand Running befindet, bewirkt diese Funktion nichts.

Siehe auch stop() und setPaused().

[signal] void QMovie::started()

Dieses Signal wird ausgesendet, 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 ausgegeben, wenn sich der Zustand des Films ändert. Der neue Zustand wird durch state angegeben.

Siehe auch QMovie::state().

[slot] void QMovie::stop()

Hält den Film an. QMovie geht in den Zustand NotRunning über und beendet die Ausgabe von updated() und resized(). Wenn start() erneut aufgerufen wird, beginnt der Film wieder von vorne.

Wenn sich QMovie bereits im Zustand NotRunning befindet, bewirkt diese Funktion nichts.

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 ausgesendet, wenn das Rect rect im aktuellen Frame aktualisiert wurde. Sie können currentImage() oder currentPixmap() aufrufen, um eine Kopie des aktualisierten Rahmens zu erhalten.