QStatusBar Class Reference - 《PyQt4 中文文档》

[ QtGui module]
- Methods
- Qt Signals
Detailed Description
Method Documentation
Qt Signal Documentation

[QtGui module]

该QStatusBar类提供适合呈现状态信息的单槓。More…

继承QWidget。

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提供了一个主应用程序窗口，带有菜单栏，工具栏，停靠小部件and围绕一个大型的中央部件的状态栏。状态栏可使用的检索QMainWindow.statusBar（）函数，并使用替代的QMainWindow.setStatusBar（）函数。

使用showMessage（）槽，以显示temporary消息：

 void MainWindow.createStatusBar()
 {
     statusBar()->showMessage(tr("Ready"));
 }

要删除一个临时消息，使用clearMessage（）槽，或调用时，设置一个时间限制showMessage（）。例如：

 void MainWindow.print()
 {
 #ifndef QT_NO_PRINTDIALOG
     [QTextDocument](docs_qtextdocument.html) *document = textEdit->document();
     [QPrinter](docs_qprinter.html) printer;
     [QPrintDialog](docs_qprintdialog.html) *dlg = new [QPrintDialog](docs_qprintdialog.html)(&printer, this);
     if (dlg->exec() != [QDialog](docs_qdialog.html).Accepted)
         return;
     document->print(&printer);
     statusBar()->showMessage(tr("Ready"), 2000);
 #endif
 }

使用currentMessage（）函数来检索当前显示的临时消息。该QStatusBar类还提供了messageChanged（）这是发射时的临时状态信息变化的信号。

Normal和Permanent消息显示通过创建一个小部件（QLabel，QProgressBar甚至QToolButton），然后用其添加到状态栏addWidget（）或addPermanentWidget（）函数。使用removeWidget（）函数从状态栏中删除此类消息。

 statusBar()->addWidget(new MyReadWriteIndication);

默认情况下QStatusBar提供QSizeGrip在右下角。您可以使用禁用的setSizeGripEnabled（）函数。使用isSizeGripEnabled（）函数来确定大小手柄的当前状态。

QStatusBar Class Reference - 图1

Method Documentation

QStatusBar.__init__ (self, QWidget parent = None)

该parent的说法，如果不是没有，原因self通过Qt的，而不是PyQt的拥有。

构造一个状态栏有一个大小的抓地力和给定parent。

See also setSizeGripEnabled（）。

QStatusBar.addPermanentWidget (self, QWidget widget, int stretch = 0)

该widget说法有它的所有权转移给Qt的。

将给定widget永久这个状态栏，重定父级的小工具，如果它已经不这样子QStatusBar对象。该stretch参数被用来计算一个合适的尺寸对于给定的widget作为状态栏的增长和收缩。默认拉伸系数为0，即给插件最小的空间。

永久意味着该插件可能无法被临时消息遮蔽。它位于状态栏的最右边。

See also insertPermanentWidget（）removeWidget（）和addWidget（）。

QStatusBar.addWidget (self, QWidget widget, int stretch = 0)

该widget说法有它的所有权转移给Qt的。

将给定widget这个状态栏，重定父级的小工具，如果它已经不这样子QStatusBar对象。该stretch参数被用来计算一个合适的尺寸对于给定的widget作为状态栏的增长和收缩。默认拉伸系数为0，即给插件最小的空间。

窗口小部件是位于最左侧的第一个永久部件（见addPermanentWidget（）），并且可以通过临时的消息遮蔽。

See also insertWidget（）removeWidget（）和addPermanentWidget（）。

QStatusBar.clearMessage (self)

这种方法也是一个Qt槽与C + +的签名void clearMessage()。

删除正在显示的任何临时消息。

See also currentMessage（）showMessage（）和removeWidget（）。

QString QStatusBar.currentMessage (self)

如果没有这样的消息返回当前显示的临时消息，或空字符串。

See also showMessage（）。

bool QStatusBar.event (self, QEvent)

从重新实现QObject.event（）。

QStatusBar.hideOrShow (self)

确保正确的窗口小部件是可见的。

所使用的showMessage（）和clearMessage（）函数。

int QStatusBar.insertPermanentWidget (self, int index, QWidget widget, int stretch = 0)

该widget说法有它的所有权转移给Qt的。

插入给定widget在给定的index永久这个状态栏，重定父级的小工具，如果它已经不这样子QStatusBar对象。如果index超出范围，小部件被追加（在这种情况下它是返回的widget的实际索引）。

该stretch参数被用来计算一个合适的尺寸对于给定的widget作为状态栏的增长和收缩。默认拉伸系数为0，即给插件最小的空间。

永久意味着该插件可能无法被临时消息遮蔽。它位于状态栏的最右边。

这个函数中引入了Qt 4.2中。

See also addPermanentWidget（）removeWidget（）和addWidget（）。

int QStatusBar.insertWidget (self, int index, QWidget widget, int stretch = 0)

该widget说法有它的所有权转移给Qt的。

插入给定widget在给定的index这个状态栏，重定父级的小工具，如果它已经不这样子QStatusBar对象。如果index超出范围，小部件被追加（在这种情况下它是返回的widget的实际索引）。

该stretch参数被用来计算一个合适的尺寸对于给定的widget作为状态栏的增长和收缩。默认拉伸系数为0，即给插件最小的空间。

窗口小部件是位于最左侧的第一个永久部件（见addPermanentWidget（）），并且可以通过临时的消息遮蔽。

这个函数中引入了Qt 4.2中。

See also addWidget（）removeWidget（）和addPermanentWidget（）。

bool QStatusBar.isSizeGripEnabled (self)

QStatusBar.paintEvent (self, QPaintEvent)

从重新实现QWidget.paintEvent（）。

示出了临时消息，如果合适，响应于所述涂料event。

QStatusBar.reformat (self)

改变状态栏的外观佔项目变更。

特殊的子类可能需要该功能，但几何管理通常会采取任何必要重排的照顾。

QStatusBar.removeWidget (self, QWidget widget)

删除指定的widget从状态栏。

Note:此功能不会删除该组件，但是hides它。再次添加窗口小部件，你必须调用两个addWidget（）和show（）函数。

See also addWidget（）addPermanentWidget（）和clearMessage（）。

QStatusBar.resizeEvent (self, QResizeEvent)

从重新实现QWidget.resizeEvent（）。

QStatusBar.setSizeGripEnabled (self, bool)

QStatusBar.showEvent (self, QShowEvent)

从重新实现QWidget.showEvent（）。

QStatusBar.showMessage (self, QString message, int msecs = 0)

这种方法也是一个Qt槽与C + +的签名void showMessage(const QString&,int = 0)。

隐藏在正常状态指示，并显示给定的message为毫秒（指定数目timeout）。如果timeout为0 （默认），message保持显示，直到clearMessage（）槽被调用，或者直到showMessage （）槽被再次调用来更改消息。

需要注意的是showMessage （）被调用，以显示工具提示文本的临时解释，所以传递_timeout_0不足以显示permanent message。

See also messageChanged（）currentMessage（）和clearMessage（）。

Qt Signal Documentation

void messageChanged (const QString&)

这是该信号的默认超载。

这个信号被发射时的临时状态信息变化。新的临时消息传递的message参数是一个空字符串时，该消息已被删除。

See also showMessage（）和clearMessage（）。