# QStatusBar Class Reference ## [[QtGui](index.htm) module] 該QStatusBar類提供適合呈現狀態信息的單槓。[More...](#details) 繼承[QWidget](qwidget.html)。 ### Methods * `__init__ (self, QWidget?parent?=?None)` * `addPermanentWidget (self, QWidget?widget, int?stretch?=?0)` * `addWidget (self, QWidget?widget, int?stretch?=?0)` * `clearMessage (self)` * `QString currentMessage (self)` * `bool event (self, QEvent)` * `hideOrShow (self)` * `int insertPermanentWidget (self, int?index, QWidget?widget, int?stretch?=?0)` * `int insertWidget (self, int?index, QWidget?widget, int?stretch?=?0)` * `bool isSizeGripEnabled (self)` * `paintEvent (self, QPaintEvent)` * `reformat (self)` * `removeWidget (self, QWidget?widget)` * `resizeEvent (self, QResizeEvent)` * `setSizeGripEnabled (self, bool)` * `showEvent (self, QShowEvent)` * `showMessage (self, QString?message, int?msecs?=?0)` ### Qt Signals * `void messageChanged (const QString&)` * * * ## Detailed Description 該QStatusBar類提供適合呈現狀態信息的單槓。 每一個狀態指示燈分為三類： * _Temporary_ - briefly occupies most of the status bar. Used to explain tool tip texts or menu entries, for example. * _Normal_ - occupies part of the status bar and may be hidden by temporary messages. Used to display the page and line number in a word processor, for example. * _Permanent_ - is never hidden. Used for important mode indications, for example, some applications put a Caps Lock indicator in the status bar. QStatusBar可以顯示所有三種類型的指標。 通常情況下，狀態欄功能的請求時就某[QMainWindow](qmainwindow.html)對象。[QMainWindow](qmainwindow.html)提供了一個主應用程序窗口，帶有菜單欄，工具欄，停靠小部件_and_圍繞一個大型的中央部件的狀態欄。狀態欄可使用的檢索[QMainWindow.statusBar](qmainwindow.html#statusBar)（）函數，并使用替代的[QMainWindow.setStatusBar](qmainwindow.html#setStatusBar)（）函數。 使用[showMessage](qstatusbar.html#showMessage)（）槽，以顯示_temporary_消息： ``` void MainWindow.createStatusBar() { statusBar()->showMessage(tr("Ready")); } ``` 要刪除一個臨時消息，使用[clearMessage](qstatusbar.html#clearMessage)（）槽，或調用時，設置一個時間限制[showMessage](qstatusbar.html#showMessage)（ ） 。例如： ``` void MainWindow.print() { #ifndef QT_NO_PRINTDIALOG [QTextDocument](qtextdocument.html) *document = textEdit->document(); [QPrinter](qprinter.html) printer; [QPrintDialog](qprintdialog.html) *dlg = new [QPrintDialog](qprintdialog.html)(&printer, this); if (dlg->exec() != [QDialog](qdialog.html).Accepted) return; document->print(&printer); statusBar()->showMessage(tr("Ready"), 2000); #endif } ``` 使用[currentMessage](qstatusbar.html#currentMessage)（ ）函數來檢索當前顯示的臨時消息。該QStatusBar類還提供了[messageChanged](qstatusbar.html#messageChanged)（ ）這是發射時的臨時狀態信息變化的信號。 _Normal_和_Permanent_消息顯示通過創建一個小部件（[QLabel](qlabel.html)，[QProgressBar](qprogressbar.html)甚至[QToolButton](qtoolbutton.html)） ，然后用其添加到狀態欄[addWidget](qstatusbar.html#addWidget)（）或[addPermanentWidget](qstatusbar.html#addPermanentWidget)（）函數。使用[removeWidget](qstatusbar.html#removeWidget)（ ）函數從狀態欄中刪除此類消息。 ``` statusBar()->addWidget(new MyReadWriteIndication); ``` 默認情況下QStatusBar提供[QSizeGrip](qsizegrip.html)在右下角。您可以使用禁用的[setSizeGripEnabled](qstatusbar.html#sizeGripEnabled-prop)（）函數。使用[isSizeGripEnabled](qstatusbar.html#sizeGripEnabled-prop)（ ）函數來確定大小手柄的當前狀態。  * * * ## Method Documentation ``` QStatusBar.__init__ (self, QWidget?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。 構造一個狀態欄有一個大小的抓地力和給定_parent_。 **See also** [setSizeGripEnabled](qstatusbar.html#sizeGripEnabled-prop)（ ） 。 ``` QStatusBar.addPermanentWidget (self, QWidget?widget, int?stretch?=?0) ``` 該_widget_說法有它的所有權轉移給Qt的。 將給定_widget_永久這個狀態欄，重定父級的小工具，如果它已經不這樣子[QStatusBar](qstatusbar.html)對象。該_stretch_參數被用來計算一個合適的尺寸對于給定的_widget_作為狀態欄的增長和收縮。默認拉伸系數為0，即給插件最小的空間。 永久意味著該插件可能無法被臨時消息遮蔽。它位于狀態欄的最右邊。 **See also** [insertPermanentWidget](qstatusbar.html#insertPermanentWidget)（ ）[removeWidget](qstatusbar.html#removeWidget)（）和[addWidget](qstatusbar.html#addWidget)（ ） 。 ``` QStatusBar.addWidget (self, QWidget?widget, int?stretch?=?0) ``` 該_widget_說法有它的所有權轉移給Qt的。 將給定_widget_這個狀態欄，重定父級的小工具，如果它已經不這樣子[QStatusBar](qstatusbar.html)對象。該_stretch_參數被用來計算一個合適的尺寸對于給定的_widget_作為狀態欄的增長和收縮。默認拉伸系數為0，即給插件最小的空間。 窗口小部件是位于最左側的第一個永久部件（見[addPermanentWidget](qstatusbar.html#addPermanentWidget)（）） ，并且可以通過臨時的消息遮蔽。 **See also** [insertWidget](qstatusbar.html#insertWidget)（ ）[removeWidget](qstatusbar.html#removeWidget)（）和[addPermanentWidget](qstatusbar.html#addPermanentWidget)（ ） 。 ``` QStatusBar.clearMessage (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void clearMessage()`。 刪除正在顯示的任何臨時消息。 **See also** [currentMessage](qstatusbar.html#currentMessage)（ ）[showMessage](qstatusbar.html#showMessage)（）和[removeWidget](qstatusbar.html#removeWidget)（ ） 。 ``` QString QStatusBar.currentMessage (self) ``` 如果沒有這樣的消息返回當前顯示的臨時消息，或空字符串。 **See also** [showMessage](qstatusbar.html#showMessage)（ ） 。 ``` bool QStatusBar.event (self, QEvent) ``` 從重新實現[QObject.event](qobject.html#event)（ ） 。 ``` QStatusBar.hideOrShow (self) ``` 確保正確的窗口小部件是可見的。 所使用的[showMessage](qstatusbar.html#showMessage)（）和[clearMessage](qstatusbar.html#clearMessage)（）函數。 ``` int QStatusBar.insertPermanentWidget (self, int?index, QWidget?widget, int?stretch?=?0) ``` 該_widget_說法有它的所有權轉移給Qt的。 插入給定_widget_在給定的_index_永久這個狀態欄，重定父級的小工具，如果它已經不這樣子[QStatusBar](qstatusbar.html)對象。如果_index_超出范圍，小部件被追加（在這種情況下它是返回的widget的實際索引） 。 該_stretch_參數被用來計算一個合適的尺寸對于給定的_widget_作為狀態欄的增長和收縮。默認拉伸系數為0，即給插件最小的空間。 永久意味著該插件可能無法被臨時消息遮蔽。它位于狀態欄的最右邊。 這個函數中引入了Qt 4.2中。 **See also** [addPermanentWidget](qstatusbar.html#addPermanentWidget)（ ）[removeWidget](qstatusbar.html#removeWidget)（）和[addWidget](qstatusbar.html#addWidget)（ ） 。 ``` int QStatusBar.insertWidget (self, int?index, QWidget?widget, int?stretch?=?0) ``` 該_widget_說法有它的所有權轉移給Qt的。 插入給定_widget_在給定的_index_這個狀態欄，重定父級的小工具，如果它已經不這樣子[QStatusBar](qstatusbar.html)對象。如果_index_超出范圍，小部件被追加（在這種情況下它是返回的widget的實際索引） 。 該_stretch_參數被用來計算一個合適的尺寸對于給定的_widget_作為狀態欄的增長和收縮。默認拉伸系數為0，即給插件最小的空間。 窗口小部件是位于最左側的第一個永久部件（見[addPermanentWidget](qstatusbar.html#addPermanentWidget)（）） ，并且可以通過臨時的消息遮蔽。 這個函數中引入了Qt 4.2中。 **See also** [addWidget](qstatusbar.html#addWidget)（ ）[removeWidget](qstatusbar.html#removeWidget)（）和[addPermanentWidget](qstatusbar.html#addPermanentWidget)（ ） 。 ``` bool QStatusBar.isSizeGripEnabled (self) ``` ``` QStatusBar.paintEvent (self, QPaintEvent) ``` 從重新實現[QWidget.paintEvent](qwidget.html#paintEvent)（ ） 。 示出了臨時消息，如果合適，響應于所述涂料_event_。 ``` QStatusBar.reformat (self) ``` 改變狀態欄的外觀佔項目變更。 特殊的子類可能需要該功能，但幾何管理通常會采取任何必要重排的照顧。 ``` QStatusBar.removeWidget (self, QWidget?widget) ``` 刪除指定的_widget_從狀態欄。 **Note:**此功能不會刪除該組件，但是_hides_它。再次添加窗口小部件，你必須調用兩個[addWidget](qstatusbar.html#addWidget)（）和[show](qwidget.html#show)（）函數。 **See also** [addWidget](qstatusbar.html#addWidget)（ ）[addPermanentWidget](qstatusbar.html#addPermanentWidget)（）和[clearMessage](qstatusbar.html#clearMessage)（ ） 。 ``` QStatusBar.resizeEvent (self, QResizeEvent) ``` 從重新實現[QWidget.resizeEvent](qwidget.html#resizeEvent)（ ） 。 ``` QStatusBar.setSizeGripEnabled (self, bool) ``` ``` QStatusBar.showEvent (self, QShowEvent) ``` 從重新實現[QWidget.showEvent](qwidget.html#showEvent)（ ） 。 ``` QStatusBar.showMessage (self, QString?message, int?msecs?=?0) ``` 這種方法也是一個Qt槽與C + +的簽名`void showMessage(const QString&,int = 0)`。 隱藏在正常狀態指示，并顯示給定的_message_為毫秒（指定數目_timeout_） 。如果_timeout_為0 （默認），_message_保持顯示，直到[clearMessage](qstatusbar.html#clearMessage)（ ）槽被調用，或者直到showMessage （）槽被再次調用來更改消息。 需要注意的是showMessage （ ）被調用，以顯示工具提示文本的臨時解釋，所以傳遞_timeout_0不足以顯示[permanent message](qstatusbar.html#permanent-message)。 **See also** [messageChanged](qstatusbar.html#messageChanged)（ ）[currentMessage](qstatusbar.html#currentMessage)（）和[clearMessage](qstatusbar.html#clearMessage)（ ） 。 * * * ## Qt Signal Documentation ``` void messageChanged (const QString&) ``` 這是該信號的默認超載。 這個信號被發射時的臨時狀態信息變化。新的臨時消息傳遞的_message_參數是一個空字符串時，該消息已被刪除。 **See also** [showMessage](qstatusbar.html#showMessage)（）和[clearMessage](qstatusbar.html#clearMessage)（ ） 。