Qt的启动界面QSplashScreen详解

Qt的启动界面QSplashScreen详解

通常在程序启动的时候，程序需要进行一些初始化的操作，如连接网络，加载数据等等。而当这些操作耗费的时间超过2秒左右，这会给用户造成不太愉快的体验。因此通常程序在这种情况下，都会在主界面加载完成之前提供一个启动界面。Qt则专门提供了一个简单好用的QSplashScreen类来实现启动界面的功能。

头文件解析

QSplashScreen的头文件如下所示

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)
};

使用场景

一般是在main函数当前使用，代码如下。

#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 类的基本介绍和使用