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

成员函数文档

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

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

另请参阅 setFileName(),setDevice() 和setFormat().

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

构造一个 QMovie 对象。QMovie 将从device 读取图像数据，并假定 已打开且可读。如果format 不为空，QMovie 将使用图像格式format 来解码图像数据。否则，QMovie 将尝试猜测格式。

parent 对象将传递给QObject 的构造函数。

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

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

parent 对象将传递给QObject 的构造函数。

[virtual 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()。

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

当播放过程中出现错误error 时，QMovie 会发出该信号。QMovie 会停止播放影片，并进入QMovie::NotRunning 状态。

另请参阅 lastError() 和lastErrorString()。

QString QMovie::fileName() const

返回QMovie 读取图像数据的文件名。如果没有指定文件名，或指定的设备不是文件，则返回空QString 。

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

[signal] void QMovie::finished()

该信号在电影结束时发出。

另请参阅 QMovie::stop().

QByteArray QMovie::format() const

返回QMovie 在解码图像数据时使用的格式。如果未指定格式，则返回空 QByteArray()。

另请参阅 setFormat().

[signal] 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 。

[slot] bool QMovie::jumpToNextFrame()

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

QImageReader::ImageReaderError QMovie::lastError() const

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

另请参阅 lastErrorString()。

QString QMovie::lastErrorString() const

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

另请参阅 lastError()。

int QMovie::loopCount() const

返回电影结束前的循环次数。如果影片只播放一次（不循环），loopCount 返回 0；如果影片永远循环播放，loopCount 返回-1。

请注意，如果图像数据来自顺序设备（如套接字），QMovie 只能在cacheMode 设置为QMovie::CacheAll 时循环播放影片。

int QMovie::nextFrameDelay() const

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

[signal] 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()。

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

如果paused 为 true，QMovie 将进入Paused 状态并发出stateChanged （暂停）；否则将进入Running 状态并发出stateChanged （运行）。

另请参阅 state() 。

void QMovie::setScaledSize(const QSize &size)

将缩放后的帧大小设置为size 。

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

[slot] void QMovie::start()

开始播放电影。QMovie 将进入Running 状态，并随着电影的播放开始发出updated() 和resized() 信号。

如果QMovie 处于Paused 状态，则此函数等同于调用setPaused(false)。如果QMovie 已处于Running 状态，则此函数不会执行任何操作。

另请参阅 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)

每次影片状态发生变化时都会发出该信号。新状态由state 指定。

另请参见 QMovie::state() 。

[slot] void QMovie::stop()

QMovie 进入NotRunning 状态，并停止发送updated() 和resized() 。如果再次调用start() ，影片将从头开始。

如果QMovie 已处于NotRunning 状态，则此函数不会执行任何操作。

另请参见 start() 和setPaused()。

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

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

另请参见 QImageReader::supportedImageFormats()。

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

当当前帧中的矩形rect 已更新时，就会发出该信号。您可以调用currentImage() 或currentPixmap() 来获取更新帧的副本。