QMovie类

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

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

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

成员函数文档

[显式构造函数] QMovie::QMovie(QObject *parent = nullptr)

构造一个QMovie对象，将父对象传递给QObject构造函数。

参见setFileName()、setDevice()和setFormat()。

[显式构造函数] QMovie::QMovie(QIODevice *device，const QByteArray &format = QByteArray()，QObject *parent = nullptr)

构建一个QMovie对象。QMovie将从设备中读取图像数据，它假设该设备是打开且可读的。如果格式不为空，QMovie将使用图像格式格式解码图像数据。否则，QMovie将尝试猜测格式。

父对象被传递给QObject的构造函数。

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

构建一个QMovie对象。QMovie将从fileName读取图像数据。如果格式不为空，QMovie将使用图像格式格式来解码图像数据。否则，QMovie将尝试猜测格式。

父对象被传递给QObject的构造函数。

[虚函数 noexcept] QMovie::~QMovie()

销毁QMovie对象。

QColor QMovie::backgroundColor() const

返回电影的背景颜色。如果没有分配背景颜色，则返回无效的QColor。

另请参阅setBackgroundColor。

int QMovie::currentFrameNumber() const

返回当前帧的序列号。电影的第一个帧编号为0。

QImage QMovie::currentImage() const

将当前帧作为QImage返回。

另请参阅currentPixmap() 和 updated。

QPixmap QMovie::currentPixmap() const

将当前帧作为QPixmap返回。

另请参阅currentImage() 和 updated。

QIODevice *QMovie::device() const

返回QMovie从其读取图像数据的设备。如果没有分配设备，则返回nullptr。

另请参阅setDevice() 和 fileName。

[信号] void QMovie::error(QImageReader::ImageReaderError error)

当播放过程中发生错误error时，这个信号由QMovie发出。QMovie将停止电影，并进入QMovie::NotRunning状态。

另请参阅lastError() 和 lastErrorString。

QString QMovie::fileName() const

返回QMovie从其中读取图像数据的文件名。如果没有分配文件名，或者分配的设备不是文件，则返回一个空的QString。

另请参阅 setFileName()和device()。

[信号] void QMovie::finished()

当电影播放完成时发出此信号。

另请参阅 QMovie::stop。

QByteArray QMovie::format() const

返回QMovie解码图像数据时使用的格式。如果没有分配格式，则返回空的QByteArray()。

另请参阅 setFormat。

[信号] void QMovie::frameChanged(int frameNumber)

当帧号变为frameNumber时发出此信号。您可以调用currentImage或currentPixmap来获取帧的副本。

int QMovie::frameCount() const

返回电影中的帧数。

某些动画格式不支持此功能，在这种情况下返回0。

QRect QMovie::frameRect() const

返回最后一帧的矩形。如果尚未更新任何帧，则返回无效的QRect。

另请参阅 currentImage和currentPixmap。

bool QMovie::isValid() const

如果电影有效（例如，图像数据可读并且图像格式受支持），则返回true；否则返回false。

有关电影为何无效的信息，请参阅lastError。

bool QMovie::jumpToFrame(int frameNumber)

跳转到帧号frameNumber。成功时返回true；否则返回false。

[槽] bool QMovie::jumpToNextFrame()

跳转到下一帧。成功时返回true；否则返回false。

QImageReader::ImageReaderError QMovie::lastError() const

返回在尝试读取图像数据时发生的最新错误。

另请参阅 lastErrorString。

QString QMovie::lastErrorString() const

返回尝试读取图像数据时发生的最新错误的可读表示形式。

另请参阅 lastError。

int QMovie::loopCount() const

返回电影在完成之前将循环的次数。如果电影只会播放一次（没有循环），则loopCount返回0。如果电影永远循环，则loopCount返回-1。

请注意，如果图像数据来自顺序设备（例如套接字），则只有当cacheMode设置为QMovie::CacheAll时，QMovie才能循环电影。

int QMovie::nextFrameDelay() const

返回QMovie在更新动画中的下一帧之前将等待的毫秒数。

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

当当前帧被调整至size时，会发出此信号。这种效果有时在动画中用作替换帧的替代方案。您可以调用currentImage()或currentPixmap()以获取已更新帧的副本。

QSize QMovie::scaledSize()

返回帧的缩放尺寸。

另请参阅setScaledSize()和QImageReader::scaledSize。

void QMovie::setBackgroundColor(const QColor &color)

对于支持此功能的图像格式，此函数将背景颜色设置为color。

另请参阅backgroundColor。

void QMovie::setDevice(QIODevice *device)

将当前设备设置为device。QMovie将在电影运行时从这个设备读取图像数据。

另请参阅device()和setFormat。

void QMovie::setFileName(const QString &fileName)

将QMovie从文件中读取图像数据的文件名设置为fileName。

另请参阅fileName(), setDevice(),和setFormat。

void QMovie::setFormat(const QByteArray &format)

将QMovie在解码图像数据时使用的格式设置为format。默认情况下，QMovie将尝试猜测图像数据格式。

您可以通过调用supportedFormats()获取QMovie支持的全部格式的完整列表。

另请参阅format()和QImageReader::supportedImageFormats。

[槽函数] void QMovie::setPaused(bool paused)

如果暂停为真，QMovie将进入暂停状态并发出状态改变(Paused); 否则它将进入运行状态并发出状态改变(Running)。

另请参阅状态()。

void QMovie::setScaledSize(const QSize &size)

设置缩放帧大小为大小。

另请参阅scaledSize()和QImageReader::setScaledSize。

[slot] void QMovie::start()

开始播放电影。 QMovie将进入运行状态，并在电影播放过程中开始发出updated()和resized()。

如果QMovie处于暂停状态，此函数等同于调用setPaused(false)。如果QMovie已经是运行状态，则此函数什么都不做。

另请参阅stop()和setPaused。

[signal] void QMovie::started()

在调用QMovie::start()之后和QMovie进入QMovie::Running状态时发出此信号。

QMovie::MovieState QMovie::state() const

返回QMovie的当前状态。

另请参阅MovieState和stateChanged。

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

每当电影的状态发生改变时都会发出此信号。新的状态由状态指定。

另请参阅QMovie::state。

[slot] void QMovie::stop()

停止播放电影。 QMovie进入NotRunning状态，并停止发出updated()和resized()。如果再次调用start()，电影将从头开始重新播放。

如果QMovie已经是NotRunning状态，则此函数不做什么。

另请参阅start()和setPaused。

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

返回QMovie支持的图像格式的列表。

参见QImageReader::supportedImageFormats。

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

当当前帧中的矩形区域 rect 被更新时，会发出此信号。您可以通过调用 currentImage() 或 currentPixmap() 获取更新帧的副本。