[新增模块LoadingIndicator]：在项目中添加了加载指示器模块，支持GIF动画显示

- 在CMakeLists.txt中添加了对新模块LoadingIndicator的引用，使其成为项目的一部分。
- 创建了LoadingIndicator模块的CMakeLists.txt文件，定义了模块的源文件和资源，以及如何构建和链接该模块。
- 添加了LoadingIndicator模块的.pro文件，配置了模块的Qt组件和编译选项。
- 实现了LoadingIndicator类，该类负责显示一个GIF动画作为加载指示器。
- 定义了LoadingIndicator类的头文件，提供了类的接口和成员函数声明。
- 编写了main.cc文件，作为LoadingIndicator模块的主函数入口。
- 实现了MainWindow类，提供了一个按钮用于触发加载指示器的显示。
- 定义了MainWindow类的头文件，声明了MainWindow类和相关的槽函数。
- 添加了LoadingIndicator模块的图片资源和GIF动画资源文件。
- 更新了Qt-Examples.pro文件，将LoadingIndicator模块加入到项目子目录中。
- 更新了README.md文件，添加了LoadingIndicator模块的介绍和图片展示。

Author: RealChuan

CMakeLists.txt

@@ -41,6 +41,7 @@ add_subdirectory(GridViewModel)
 add_subdirectory(HttpClient)
 add_subdirectory(IconButton)
 add_subdirectory(ImageCarousel)
+add_subdirectory(LoadingIndicator)
 add_subdirectory(LogAsynchronous)
 add_subdirectory(MulClient)
 add_subdirectory(MulServer)

LoadingIndicator/CMakeLists.txt

@@ -0,0 +1,9 @@
+set(PROJECT_SOURCES loadingindicator.cc loadingindicator.hpp main.cc
+                    mainwindow.cc mainwindow.hpp)
+
+qt_add_resources(SOURCES resource.qrc)
+
+qt_add_executable(LoadingIndicator MANUAL_FINALIZATION ${PROJECT_SOURCES}
+                  ${SOURCES})
+target_link_libraries(LoadingIndicator PRIVATE Qt6::Widgets)
+qt_finalize_executable(LoadingIndicator)

LoadingIndicator/LoadingIndicator.pro

@@ -0,0 +1,26 @@
+QT       += core gui
+
+greaterThan(QT_MAJOR_VERSION, 4): QT += widgets
+
+CONFIG += c++17
+
+# 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.0
+
+SOURCES += \
+    loadingindicator.cc \
+    main.cc \
+    mainwindow.cc
+
+HEADERS += \
+    loadingindicator.hpp \
+    mainwindow.hpp
+
+# Default rules for deployment.
+qnx: target.path = /tmp/$${TARGET}/bin
+else: unix:!android: target.path = /opt/$${TARGET}/bin
+!isEmpty(target.path): INSTALLS += target
+
+RESOURCES += \
+    resource.qrc

LoadingIndicator/loadingindicator.cc

@@ -0,0 +1,65 @@
+#include "loadingindicator.hpp"
+
+#include <QtWidgets>
+
+class LoadingIndicator::LoadingIndicatorPrivate
+{
+public:
+    explicit LoadingIndicatorPrivate(LoadingIndicator *q)
+        : q_ptr(q)
+        , movie(new QMovie(":/gif/resource/loading.gif", {}, q_ptr))
+    {
+        movie->setCacheMode(QMovie::CacheAll);
+    }
+
+    void setupUI()
+    {
+        auto *label = new QLabel(q_ptr);
+        label->setFixedSize(50, 50);
+        label->setScaledContents(true);
+        label->setMovie(movie);
+        movie->setScaledSize(label->size());
+
+        auto *layout = new QHBoxLayout(q_ptr);
+        layout->addWidget(label, 0, Qt::AlignCenter);
+    }
+
+    LoadingIndicator *q_ptr;
+
+    QMovie *movie;
+};
+
+LoadingIndicator::LoadingIndicator(QWidget *parent)
+    : QWidget{parent}
+    , d_ptr(new LoadingIndicatorPrivate(this))
+{
+    d_ptr->setupUI();
+    QMetaObject::invokeMethod(this, [this] { showLoading(); }, Qt::QueuedConnection);
+}
+
+LoadingIndicator::~LoadingIndicator() {}
+
+void LoadingIndicator::showLoading(QWidget *parent)
+{
+    if (parent == nullptr) {
+        parent = parentWidget();
+    }
+    if (parent == nullptr) {
+        parent = qApp->activeWindow();
+    }
+    setParent(parent);
+    resize(parent->size());
+
+    setWindowFlags(windowFlags() | Qt::FramelessWindowHint | Qt::Tool);
+    setAttribute(Qt::WA_TranslucentBackground);
+    setWindowModality(Qt::ApplicationModal);
+
+    show();
+    d_ptr->movie->start();
+}
+
+void LoadingIndicator::hideLoading()
+{
+    d_ptr->movie->stop();
+    hide();
+}

LoadingIndicator/loadingindicator.hpp

@@ -0,0 +1,18 @@
+#pragma once
+
+#include <QWidget>
+
+class LoadingIndicator : public QWidget
+{
+    Q_OBJECT
+public:
+    explicit LoadingIndicator(QWidget *parent = nullptr);
+    ~LoadingIndicator();
+
+    void showLoading(QWidget *parent = nullptr);
+    void hideLoading();
+
+private:
+    class LoadingIndicatorPrivate;
+    QScopedPointer<LoadingIndicatorPrivate> d_ptr;
+};

LoadingIndicator/main.cc

@@ -0,0 +1,11 @@
+#include "mainwindow.hpp"
+
+#include <QApplication>
+
+int main(int argc, char *argv[])
+{
+    QApplication a(argc, argv);
+    MainWindow w;
+    w.show();
+    return a.exec();
+}

LoadingIndicator/mainwindow.cc

@@ -0,0 +1,22 @@
+#include "mainwindow.hpp"
+#include "loadingindicator.hpp"
+
+#include <QtWidgets>
+
+MainWindow::MainWindow(QWidget *parent)
+    : QMainWindow(parent)
+{
+    auto *button = new QPushButton(tr("Loading Indicator Button: Show 10 seconds"), this);
+    connect(button, &QPushButton::clicked, this, &MainWindow::onShowLoadingIndicator);
+    setCentralWidget(button);
+
+    resize(300, 185);
+}
+
+MainWindow::~MainWindow() {}
+
+void MainWindow::onShowLoadingIndicator()
+{
+    auto *loadingIndicator = new LoadingIndicator(this);
+    QTimer::singleShot(10000, loadingIndicator, &LoadingIndicator::deleteLater);
+}

LoadingIndicator/mainwindow.hpp

@@ -0,0 +1,15 @@
+#pragma once
+
+#include <QMainWindow>
+
+class MainWindow : public QMainWindow
+{
+    Q_OBJECT
+
+public:
+    MainWindow(QWidget *parent = nullptr);
+    ~MainWindow();
+
+private slots:
+    void onShowLoadingIndicator();
+};

LoadingIndicator/picture/LoadingIndicator.jpg

@@ -0,0 +1,5 @@
+<RCC>
+    <qresource prefix="/gif">
+        <file>resource/loading.gif</file>
+    </qresource>
+</RCC>