QSplashScreen Class

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);
    QPixmap pixmap(":/splash.png");
    QSplashScreen splash(pixmap);
    splash.show();
    app.processEvents();
    //...
    QMainWindow window;
    window.show();
    splash.finish(&window);
    return app.exec();
}

QPixmap pixmap(":/splash.png");
QSplashScreen *splash = new QSplashScreen(pixmap);
splash->show();

... // Loading some items
splash->showMessage("Loaded modules");

QCoreApplication::processEvents();

... // Establishing connections
splash->showMessage("Established connections");

QCoreApplication::processEvents();

QScreen *screen = QGuiApplication::screens().at(1);
QPixmap pixmap(":/splash.png");
QSplashScreen splash(screen, pixmap);
splash.show();

成员函数文档

[explicit] QSplashScreen::QSplashScreen(const QPixmap &pixmap = QPixmap(), Qt::WindowFlags f = Qt::WindowFlags())

构建一个启动画面，用于显示pixmap 。

通常无需设置控件标志（f ），除非需要启用Qt::WindowStaysOnTopHint 。

QSplashScreen::QSplashScreen(QScreen *screen, const QPixmap &pixmap = QPixmap(), Qt::WindowFlags f = Qt::WindowFlags())

此函数允许您指定启动画面的屏幕。该构造函数的典型用法是：当您拥有多个屏幕，且希望将启动画面显示在主屏幕以外的其他屏幕上时。在这种情况下，请传入相应的screen 。

[virtual noexcept] QSplashScreen::~QSplashScreen()

析构函数。

[slot] void QSplashScreen::clearMessage()

清除启动画面上显示的消息

另请参阅 showMessage()。

[virtual protected] void QSplashScreen::drawContents(QPainter *painter)

使用 painterpainter 绘制启动画面的内容。默认实现会绘制由showMessage() 传递的消息。若要在启动画面上进行自定义绘制，请重写此函数。

[override virtual protected] bool QSplashScreen::event(QEvent *e)

重写了：QWidget::event(QEvent *event)。

void QSplashScreen::finish(QWidget *mainWin)

使启动画面在显示小部件mainWin 之后，才调用其自身的close() 方法。

QString QSplashScreen::message() const

返回当前在启动画面上显示的消息。

另请参阅 ` showMessage()` 和 `clearMessage()`。

[signal] void QSplashScreen::messageChanged(const QString &message)

当启动画面上的消息发生变化时，会发出此信号。message 表示新消息；若消息已被移除，则该参数为空字符串。

另请参阅 showMessage() 和clearMessage()。

[override virtual protected] void QSplashScreen::mousePressEvent(QMouseEvent *)

重写了：QWidget::mousePressEvent(QMouseEvent *event)。

const QPixmap QSplashScreen::pixmap() const

返回用于启动画面的位图。该图像不包含由showMessage() 调用绘制的任何文本。

另请参阅 setPixmap()。

void QSplashScreen::repaint()

该函数重写了QWidget::repaint()。它与标准的repaint函数的不同之处在于，它还会调用QCoreApplication::processEvents()，以确保即使没有事件循环，更新内容也能被显示出来。

void QSplashScreen::setPixmap(const QPixmap &pixmap)

将用作启动画面的位图设置为pixmap 。

另请参阅 pixmap()。

[slot] void QSplashScreen::showMessage(const QString &message, int alignment = Qt::AlignLeft, const QColor &color = Qt::black)

将文本“message ”以颜色color 绘制到启动画面上，并根据alignment 中的标志对齐文本。该函数调用repaint()以确保立即重绘启动画面。因此，该消息能实时反映应用程序的当前状态（例如正在加载文件）。

另请参阅 Qt::Alignment 、clearMessage() 以及message()。