# QSplashScreen Class Reference ## [[QtGui](index.htm) module] 該QSplashScreen小工具提供了可以在應用程序啟動時顯示啟動畫面。[More...](#details) 繼承[QWidget](qwidget.html)。 ### Methods * `__init__ (self, QPixmap?pixmap?=?QPixmap(), Qt.WindowFlags?flags?=?0)` * `__init__ (self, QWidget?parent, QPixmap?pixmap?=?QPixmap(), Qt.WindowFlags?flags?=?0)` * `clearMessage (self)` * `drawContents (self, QPainter?painter)` * `bool event (self, QEvent?e)` * `finish (self, QWidget?w)` * `mousePressEvent (self, QMouseEvent)` * `QPixmap pixmap (self)` * `repaint (self)` * `setPixmap (self, QPixmap?pixmap)` * `showMessage (self, QString?message, int?alignment?=?Qt.AlignLeft, QColor?color?=?Qt.black)` ### Qt Signals * `void messageChanged (const QString&)` * * * ## Detailed Description 該QSplashScreen小工具提供了可以在應用程序啟動時顯示啟動畫面。 啟動畫面是當一個應用程序被啟動，通常是顯示一個小部件。閃屏通常用于應用程序早就啟動時間（如數據庫或需要時間來建立連接的網絡應用程序）向用戶提供反饋，該應用程序加載。 在啟動畫面出現在屏幕中央。它可能是有用的添加[Qt.WindowStaysOnTopHint](qt.html#WindowType-enum)在飛濺小部件的窗口標志，如果你想保留它上面的所有桌面上的其他窗口。 有些X11窗口管理器不支持標志“之上停留” 。一個解決辦法是設置一個定期調用一個計時器[raise_](qwidget.html#raise)（ ）閃屏模擬“停留在頂部”的效果上。 最常見的用法是顯示一個啟動畫面的主窗口部件被顯示在屏幕上之前。說明了這一點，其中一個啟動畫面顯示和一些初始化任務執行應用程序的主窗口顯示之前，下面的代碼片段： ``` int main(int argc, char *argv[]) { [QApplication](qapplication.html) app(argc, argv); [QPixmap](qpixmap.html) pixmap(":/splash.png"); QSplashScreen splash(pixmap); splash.show(); app.processEvents(); ... [QMainWindow](qmainwindow.html) window; window.show(); splash.finish(&window); return app.exec(); } ``` 用戶可以通過點擊鼠標隱藏的啟動畫面。由于之前的事件循環已經開始運行啟動畫面通常顯示，它以定期調用是必要的[QApplication.processEvents](qcoreapplication.html#processEvents)（）接收的鼠標點擊。 它來更新消息中的閃屏有時是有用的，例如，宣布建立或加載的應用程序模塊啟動時連接： ``` [QPixmap](qpixmap.html) pixmap(":/splash.png"); QSplashScreen *splash = new QSplashScreen(pixmap); splash->show(); ... // Loading some items splash->showMessage("Loaded modules"); qApp->processEvents(); ... // Establishing connections splash->showMessage("Established connections"); qApp->processEvents(); ``` QSplashScreen支持此同[showMessage](qsplashscreen.html#showMessage)（）函數。如果你希望做自己的繪圖，你可以得到一個指向在啟動畫面中使用的像素圖與[pixmap](qsplashscreen.html#pixmap)（ ） 。或者，你可以繼承QSplashScreen和重新實現[drawContents](qsplashscreen.html#drawContents)（ ） 。 * * * ## Method Documentation ``` QSplashScreen.__init__ (self, QPixmap?pixmap?=?QPixmap(), Qt.WindowFlags?flags?=?0) ``` 構造一個初始屏幕，將顯示_pixmap_。 應該沒有必要設置窗口部件標記，_f_，也許除了[Qt.WindowStaysOnTopHint](qt.html#WindowType-enum)。 ``` QSplashScreen.__init__ (self, QWidget?parent, QPixmap?pixmap?=?QPixmap(), Qt.WindowFlags?flags?=?0) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。 這是一個重載函數。 此功能允許您指定一個父為您的啟動畫面。典型的使用此構造函數是，如果你有多個屏幕，并希望有閃屏不同的屏幕比你小一上。在這種情況下，通過適當的桌面（）中作為_parent_。 ``` QSplashScreen.clearMessage (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void clearMessage()`。 刪除所顯示的初始屏幕上的消息 **See also** [showMessage](qsplashscreen.html#showMessage)（ ） 。 ``` QSplashScreen.drawContents (self, QPainter?painter) ``` 用畫家繪制的啟動畫面中的內容_painter_。默認實現繪制由傳遞消息[showMessage](qsplashscreen.html#showMessage)（ ） 。如果你想要做自己的繪圖啟動畫面上重新實現這個函數。 ``` bool QSplashScreen.event (self, QEvent?e) ``` 從重新實現[QObject.event](qobject.html#event)（ ） 。 ``` QSplashScreen.finish (self, QWidget?w) ``` 讓啟動畫面等到小部件_mainWin_呼叫前顯示[close](qwidget.html#close)（ ）自身。 ``` QSplashScreen.mousePressEvent (self, QMouseEvent) ``` 從重新實現[QWidget.mousePressEvent](qwidget.html#mousePressEvent)（ ） 。 ``` QPixmap QSplashScreen.pixmap (self) ``` [](qpixmap.html) [返回用于在啟動畫面的像素圖。圖像沒有任何被繪制文本](qpixmap.html)[showMessage](qsplashscreen.html#showMessage)（ ）調用。 **See also** [setPixmap](qsplashscreen.html#setPixmap)（ ） 。 ``` QSplashScreen.repaint (self) ``` 這將復蓋[QWidget.repaint](qwidget.html#repaint)（ ） 。其不同之處在于它也調用標準重繪函數[QApplication.flush](qcoreapplication.html#flush)（） ，以確保所顯示的更新時，甚至當沒有事件循環存在。 ``` QSplashScreen.setPixmap (self, QPixmap?pixmap) ``` 設置將用作啟動畫面的圖像的像素圖_pixmap_。 **See also** [pixmap](qsplashscreen.html#pixmap)（ ） 。 ``` QSplashScreen.showMessage (self, QString?message, int?alignment?=?Qt.AlignLeft, QColor?color?=?Qt.black) ``` 這種方法也是一個Qt槽與C + +的簽名`void showMessage(const QString&,int = Qt.AlignLeft,const QColor& = Qt.black)`。 繪制_message_文字上有顏色的閃屏_color_和對齊根據在標志的文本_alignment_。 為了確保在啟動畫面立即重繪，你可以調用[QCoreApplication](qcoreapplication.html)的[processEvents()](qcoreapplication.html#processEvents)調用showMessage （）之后。通常你想這確保該消息被不斷更新與你的應用程序在做（例如，加載文件） 。 **See also** [Qt.Alignment](qt.html#AlignmentFlag-enum)和[clearMessage](qsplashscreen.html#clearMessage)（ ） 。 * * * ## Qt Signal Documentation ``` void messageChanged (const QString&) ``` 這是該信號的默認超載。 這個信號被發射時，在啟動畫面變化的消息。_message_是新的消息，當該消息已被刪除一個空字符串。 **See also** [showMessage](qsplashscreen.html#showMessage)（）和[clearMessage](qsplashscreen.html#clearMessage)（ ） 。