QSplashScreen 类

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

成员函数文档

[显式] 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。

[虚 noexcept] QSplashScreen::~QSplashScreen()

析构函数。

[槽函数] void QSplashScreen::clearMessage()

移除正在启动画面上显示的消息

参见showMessage().

[虚受保护] void QSplashScreen::drawContents(QPainter *painter)

使用绘图器painter绘制启动画面的内容。默认实现使用showMessage()传递的消息进行绘图。如果想要在启动画面上进行自己的绘图，则需要重新实现此函数。

[覆盖虚受保护] bool QSplashScreen::event(QEvent *e)

重新实现: QWidget::event(QEvent *event).

void QSplashScreen::finish(QWidget *mainWin)

在调用自身的 close() 之前，使启动窗口等待窗口 mainWin 显示。

QString QSplashScreen::message() const

返回当前在启动窗口上显示的消息。

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

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

当启动窗口上的消息改变时，会发出此信号。message 是新的消息，如果不显示消息则是空字符串。

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

[重载虚受保护的] void QSplashScreen::mousePressEvent(QMouseEvent *)

重新实现: QWidget::mousePressEvent(QMouseEvent *event).

const QPixmap QSplashScreen::pixmap() const

返回用于启动窗口的位图。图像不包括由 showMessage() 调用的文本生成的任何文本。

另请参阅setPixmap().

void QSplashScreen::repaint()

这覆盖了 QWidget::repaint。它与传统重新绘制函数的不同之处在于，它还调用 QCoreApplication::processEvents() 以确保更新被显示，即使在没有事件循环的情况下。

void QSplashScreen::setPixmap(const QPixmap &pixmap)

将作为启动窗口图像使用的位图设置为 pixmap。

另请参阅pixmap().

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

以颜色 color 在启动窗口上绘制文本 message 并根据 alignment 中的标志对齐文本。这个函数调用 repaint()，确保启动窗口立即重新绘制。因此，消息与您的应用程序正在执行的操作（例如加载文件）保持同步。

另请参阅Qt::Alignment、clearMessage() 和 message().