Qt中播放GIF动画

在Qt应用程序中，如果你想在QLabel控件上播放GIF动画，可以使用QMovie类与QLabel配合来实现。以下是详细步骤和代码示例：

步骤1：引入必要的头文件

首先，在你的源代码文件中包含QMovie和QLabel相关的头文件：

#include <QLabel>
#include <QMovie>

步骤2：创建QLabel和QMovie对象

在你的类中创建一个QLabel实例和一个QMovie实例。QMovie负责加载和播放GIF动画，QLabel则用来显示动画的内容。

QLabel *gifLabel = new QLabel(this); // 假设' this '是指向包含QLabel的父窗口或布局
QMovie *movie = new QMovie(":/resources/loading.gif"); // 加载资源文件中的GIF动画// 或者加载本地文件
// QMovie *movie = new QMovie("path_to_your_gif_file.gif");if (!movie->isValid()) { // 检查GIF是否有效qDebug() << "Invalid GIF file!";
} else {gifLabel->setMovie(movie);
}

步骤3：设置QLabel属性和启动QMovie

如果GIF文件有效，将其关联到QLabel上，并开始播放动画。

gifLabel->setAlignment(Qt::AlignCenter); // 可以根据需要设置对齐方式
movie->start(); // 开始播放GIF动画// 若需要自适应GIF大小
gifLabel->setScaledContents(true); // 自动缩放GIF内容以适应QLabel尺寸

示例完整代码片段：

代码缺少MainWindow.ui，随便新建一个即可。最简单的方法是根据QtCreator向导新建MainWindow项目，然后复制MainWindow.cpp文件即可。
demo.pro

QT       += core gui
QT += multimedia multimediawidgetsgreaterThan(QT_MAJOR_VERSION, 4): QT += widgetsCONFIG += c++11# You can make your code fail to compile if it uses deprecated APIs.
# In order to do so, uncomment the following line.
#DEFINES += QT_DISABLE_DEPRECATED_BEFORE=0x060000    # disables all the APIs deprecated before Qt 6.0.0SOURCES += \MainWindow.cpp \main.cppHEADERS += \MainWindow.hFORMS += \MainWindow.ui# Default rules for deployment.
qnx: target.path = /tmp/$${TARGET}/bin
else: unix:!android: target.path = /opt/$${TARGET}/bin
!isEmpty(target.path): INSTALLS += targetRESOURCES += \resources.qrc

MainWindow.h

#ifndef MAINWINDOW_H
#define MAINWINDOW_H#include <QMainWindow>namespace Ui {
class MainWindow;
}class MainWindow : public QMainWindow
{Q_OBJECTpublic:explicit MainWindow(QWidget *parent = nullptr);~MainWindow();private:Ui::MainWindow *ui;
};#endif // MAINWINDOW_H

MainWindow.cpp

#include "MainWindow.h"
#include "ui_MainWindow.h"
#include <QLabel>
#include <QMovie>
#include <QVBoxLayout>
#include <QDebug>MainWindow::MainWindow(QWidget *parent) :QMainWindow(parent),ui(new Ui::MainWindow)
{ui->setupUi(this);// 创建布局QVBoxLayout *layout = new QVBoxLayout;setCentralWidget(new QWidget());centralWidget()->setLayout(layout);// 创建并初始化QMovieQMovie *movie = new QMovie(":/resources/loading.gif");if (!movie->isValid()) {qDebug() << "Failed to load GIF.";} else {// 创建并设置QLabelQLabel *gifLabel = new QLabel(this);gifLabel->setMovie(movie);gifLabel->setAlignment(Qt::AlignCenter);gifLabel->setScaledContents(true);// 开始播放GIFmovie->start();// 将QLabel添加到布局中layout->addWidget(gifLabel);}
}MainWindow::~MainWindow()
{delete ui;
}

Main.cpp

#include "MainWindow.h"
#include <QApplication>int main(int argc, char *argv[])
{QApplication app(argc, argv);MainWindow mainWindow;mainWindow.show();return app.exec();
}