Home · All Classes · Modules  · QSS HELP  · QSS 案例 · VER007 HOME

QStatusBar Class Reference
[QtGui module]

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

继承QWidget

Methods

Qt Signals


Detailed Description

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

每一个状态指示灯分为三类:

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 *document = textEdit->document();
     QPrinter printer;

     QPrintDialog *dlg = new QPrintDialog(&printer, this);
     if (dlg->exec() != QDialog.Accepted)
         return;

     document->print(&printer);

     statusBar()->showMessage(tr("Ready"), 2000);
 #endif
 }

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

NormalPermanent消息显示通过创建一个小部件(QLabelQProgressBar甚至QToolButton) ,然后用其添加到状态栏addWidget()或addPermanentWidget()函数。使用removeWidget( )函数从状态栏中删除此类消息。

 statusBar()->addWidget(new MyReadWriteIndication);

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

A status bar shown in the Plastique widget style


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 ( )被调用,以显示工具提示文本的临时解释,所以传递timeout0不足以显示permanent message

See also messageChanged( )currentMessage()和clearMessage( ) 。


Qt Signal Documentation

void messageChanged (const QString&)

这是该信号的默认超载。

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

See also showMessage()和clearMessage( ) 。




PyQt 4.10.3 for X11 Copyright © Riverbank Computing Ltd and Nokia 2012 Qt 4.8.5