Qt QSplashScreen 启动界面详解

1.功能

一个程序启动时，程序需要初始化操作比如加载数据、连接网络，一般来说比较耗时，这个时候为了用户体验，就是在程序主界面完成之前加一个启动界面。这个时候QSplashScreen刚好提供这个功能

2.头文件分析

class Q_WIDGETS_EXPORT QSplashScreen : public QWidget
{
    Q_OBJECT
public:

    /**
     *  \brief  构造函数之一
     *  \param  pixmap 图片资源
     *  \param  f 窗口的标签，如可以设置该启动界面置顶等
     */
    explicit QSplashScreen(const QPixmap &pixmap = QPixmap(), Qt::WindowFlags f = Qt::WindowFlags());

    /**
     *  \brief 如果你的电脑是多屏的那么你就可以通过QScreen来设置当前的启动界面放置在哪个屏幕上面。只在Qt5.15之后才能使用。
     *  \param screen 屏幕
     *  \param pixmap 图片资源
     *  \param f 窗口的标签，如可以设置该启动界面置顶等
     */
    QSplashScreen(QScreen *screen, const QPixmap &pixmap = QPixmap(), Qt::WindowFlags f = Qt::WindowFlags());
    /**
        * \brief 析构函数
     */
    virtual ~QSplashScreen();
    
    /**
     * \brief 在构造函数之后，再次设置图片
     * \param  pixmap 图片资源
     */
    void setPixmap(const QPixmap &pixmap);

    /**
     * \brief 返回当前的图片资源
     */
    const QPixmap pixmap() const;
    
    /**
        * \brief 一般用来设置在主界面完全显示出来之后在退出该启动界面
        * \param w 一般为主界面
     */
    void finish(QWidget *w);
    
    /**
      *  \brief  QWidget的重绘函数
     */
    void repaint();

    /**
     * \brief 返回当前的提示消息
     */
    QString message() const;

public Q_SLOTS:
    /**
     * \brief 常用的槽函数之一，用来给启动界面设置提示消息
     * \param message 提示的消息，可以为html文本
     * \param alignment 对齐方式
     * \param color 消息的颜色
     */
    void showMessage(const QString &message, int alignment = Qt::AlignLeft,
                  const QColor &color = Qt::black);
 
     /**
      * \brief 清空当前的提示消息
      */
    void clearMessage();

Q_SIGNALS:
    
    /**
     * \brief 当前的提示消息改变之后的信号
     * \param message 改变后的消息
     */
    void messageChanged(const QString &message);

protected:
    /**
     *  \brief 一些通用的事件
     */
    bool event(QEvent *e) override;
    virtual void drawContents(QPainter *painter);
    void mousePressEvent(QMouseEvent *) override;

private:
    //禁止拷贝构造
    Q_DISABLE_COPY(QSplashScreen)
    Q_DECLARE_PRIVATE(QSplashScreen)
};

3.使用场景

#include "mainwindow.h"

#include <QApplication>
#include <QSplashScreen>

int main(int argc, char *argv[])
{
  QApplication a(argc, argv);

  QPixmap pixmap(":/picture/loader.jpg");  //这里填写图片的路径
  QSplashScreen splash(pixmap);
  splash.show();  //显示启动界面

#if QT_DEPRECATED_SINCE(5, 15)   //qt5.15之后的版本
  QScreen *screen = QGuiApplication::screens().at(1);  
  QPixmap pixmap(":/Chess/picture/loader.jpg");
  QSplashScreen splash(screen, pixmap);  //设置显示到的屏幕
  splash.show();
#endif

  //启动第一阶段
  
  ... //do something
  splash.showMessage(QStringLiteral("load file"), Qt::AlignHCenter|Qt::AlignBottom, Qt::white);  //设置消息

  //用户可以通过用鼠标单击来隐藏启动画面。由于启动画面通常在事件循环开始运行之前显示，因此有必要定期调用 QCoreApplication::processEvents() 以接收鼠标点击。
  QCoreApplication::processEvents();
  
  //启动第二阶段
  
  ... //do something
  //showMessage甚至于可以接受HTML格式的字符串，它会自动解析其样式，不过这个时候最后

//一个color参数将会失效
  splash.showMessage(QStringLiteral("<div style='background:#000; color:#FFF'>背景为黑色"), Qt::AlignHCenter|Qt::AlignVCenter);
  QCoreApplication::processEvents();

  MainWindow w;
  w.show();
  splash.finish(&w);  //等到w界面显示完成之后，启动界面才会退出
  return a.exec();
}
//动态启动界面

QSplashScreen默认使用QPixmap类型的数据作为参数，直接调用gif文件或视频文件是无效的。这里需要使用QMovie实现动态画面的播放。

首先还是要定义QPixmap和QSplashScreen，然后通过一个事件循环，让gif以指定速度刷新，然后将刷新的帧画面以pixmap的方式显示。这里要注意的就是gif的播放速度要与事件循环速度匹配。

#include "toolbox.h"
#include <QApplication>
 
int main(int argc, char *argv[])
{
    QApplication a(argc, argv);
//===静态程序启动画面===
//    QPixmap pix(":/resource/splash1.png");
//    QSplashScreen splash(pix);
//    splash.show();
//    a.processEvents();
 
//===动态程序启动画面===
    QPixmap pix(":/resource/splash2.gif");
    QSplashScreen splash(pix);
    QLabel splashlabel(&splash);
    QMovie splashgif(":/resource/splash2.gif");
    splashlabel.setMovie(&splashgif);
    splashgif.start();
    splash.show();
    splash.setCursor(Qt::BlankCursor);//不显示鼠标外观
    for(int i=0;i<15000;i+=splashgif.speed()){
        QCoreApplication::processEvents();
        Sleep(splashgif.speed()/5);
    }
 
//    QCoreApplication::processEvents();
 
    toolbox w;
    w.show();
 
    splash.finish(&w);//程序启动画面结束
 
    return a.exec();
}