QSplashScreen 類

QSplashScreen 小部件提供可以展示的閃屏，在應用程序啓動期間。更多...

頭：	`#include <QSplashScreen>`
CMake:	`find_package(Qt6 REQUIRED COMPONENTS Widgets)` `target_link_libraries(mytarget PRIVATE Qt6::Widgets)`
qmake:	`QT += widgets`
繼承：	QWidget

所有成員列錶，包括繼承成員

公共函數

	QSplashScreen (const QPixmap & pixmap = QPixmap(), Qt::WindowFlags f = Qt::WindowFlags())
	QSplashScreen (QScreen * screen , const QPixmap & pixmap = QPixmap(), Qt::WindowFlags f = Qt::WindowFlags())
virtual	~QSplashScreen ()
void	finish (QWidget * mainWin )
QString	message () const
const QPixmap	pixmap () const
void	repaint ()
void	setPixmap (const QPixmap & pixmap )

公共槽

void	clearMessage ()
void	showMessage (const QString & message , int alignment = Qt::AlignLeft, const QColor & color = Qt::black)

信號

void	messageChanged (const QString & message )

保護函數

virtual void

drawContents (QPainter * painter )

重實現保護函數

virtual bool	event (QEvent * e ) override
virtual void	mousePressEvent (QMouseEvent *) override

詳細描述

閃屏是應用程序啓動時，通常顯示的 Widget。閃屏常用於長啓動時間的應用程序 (如：數據庫或花時間建立連接的網絡應用程序)，為用戶提供應用程序加載反饋。

閃屏齣現在屏幕中心。它可能很有用，添加 Qt::WindowStaysOnTopHint 到閃屏 Widget 的窗口標誌，若想要把它保持在桌麵所有其它窗口之上。

一些 X11 窗口管理器不支持 "停留在頂部" 標誌。解決方案是設置計時器周期性調用 raise () 在閃屏以模擬 "停留在頂部" 效果。

最常見用法是展示閃屏，在屏幕中顯示主 Widget 前。以下代碼片段將闡明這，顯示閃屏並履行一些初始化任務，在展示應用程序主窗口前：

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

用戶可以隱藏閃屏，通過采用鼠標點擊它。為使鼠標處理能工作，調用 QApplication::processEvents () 周期性在啓動期間。

有時很有用采用消息更新閃屏，例如，在應用程序啓動時宣布建立連接 (或加載模塊)：

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

QSplashScreen 支持這，采用 showMessage () 函數。若希望自己繪製，可以獲取用於閃屏的像素圖指針采用 pixmap ()。另外，可以子類 QSplashScreen 並重實現 drawContents ().

若擁有多個屏幕，在不同屏幕而不是首要屏幕，展示閃屏是可能的。例如：

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 .

應該不需要設置 Widget 標誌 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 )

繪製閃屏的內容，使用描繪器 painter 。默認實現繪製傳遞的消息，通過 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 為新消息，和為 null 字符串當消息已移除時。

另請參閱 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 ()。它不同於標準重新描繪函數，因為它還調用 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 ().