主页 | 所有的类 | 主要的类 | 注释的类 | 分组的类 | 函数 |
QStatusBar类参考
QStatusBar类提供了一个适合呈现状态信息的水平条。 详情请见……
#include <qstatusbar.h>
Inherits QWidget。
公有成员
- QStatusBar ( QWidget * parent = 0, const char * name = 0 )
- virtual ~QStatusBar ()
- virtual void addWidget ( QWidget * widget, int stretch = 0, bool permanent = FALSE )
- virtual void removeWidget ( QWidget * widget )
- void setSizeGripEnabled ( bool )
- bool isSizeGripEnabled () const
公有槽
- void message ( const QString & message )
- void message ( const QString & message, int ms )
- void clear ()
属性
- bool sizeGripEnabled - 在状态条右下方的QSizeGrip是否有效
保护成员
- virtual void paintEvent ( QPaintEvent * )
- void reformat ()
- void hideOrShow ()
详细描述
QStatusBar类提供了一个适合呈现状态信息的水平条。
每一个状态指示器都会落在下面这三种类别之内:
- 临时的 - 暂时地占用状态条的大部分。例如,用于解释工具提示文本或者菜单条目。
- 正常的 - 占用状态条的一部分并且也可能被临时的信息隐藏。例如,用于在字处理器中显示页数和行数。
- 永久的 - 从不被隐藏。用于重要的模式指示,例如,一些程序把大小写指示器放在状态条中。
QStatusBar让你能够显示上述所有类型的指示信息。
为了显示临时的消息,请调用message()(可以把一个合适的信号和它连接起来)。如果要移除一个临时的消息,调用clear()。这里有两类消息:一类消息一直显示到下一个clear()或mesage()被调用才消失,并且另一种是有时间限制的:
connect( loader, SIGNAL(progressMessage(const QString&)), statusBar(), SLOT(message(const QString&)) ); statusBar()->message("Loading..."); // 初始消息 loader.loadStuff(); // 发射进程消息 statusBar()->message("Done.", 2000); // 显示2秒的最后消息
正常的和永久的消息通过创建一个小窗口部件并且然后通过addWidget()把它添加到状态条中来被显示。QLabel、QProgressBar或者甚至QToolButton这些窗口部件对于添加到状态条都是很有用的。removeWidget()用于移除窗口部件。
statusBar()->addWidget(new MyReadWriteIndication(statusBar()));
默认情况下,QStatusBar在右下角提供了一个QSizeGrip。你可以使用setSizeGripEnabled(FALSE)来使它失效。
也可以参考QToolBar、QMainWindow、QLabel、图形用户界面设计手册:状态条、主窗口和相关类和帮助系统。
成员函数文档
QStatusBar::QStatusBar ( QWidget * parent = 0, const char * name = 0 )
构造一个父对象为parent、名称为name并且有一个大小控制的状态条。
也可以参考sizeGripEnabled。
QStatusBar::~QStatusBar () [虚]
销毁这个状态条并且释放任何已经分配的资源和子窗口部件。void QStatusBar::addWidget ( QWidget * widget, int stretch = 0, bool permanent = FALSE ) [虚]
把widget添加到这个状态条。如果permanent为真,widget就是永久可视的并且如果permanent为假,它也可以被临时的消息遮挡。默认为假。
如果permanent为真,widget被定位在状态条的最右面。如果permanent为假(默认),widget被调节到第一个永久窗口部件的左面。
stretch用于在状态条变大或者变小时为widget计算一个合适的大小。默认为0是指使用最小的空间。
这个函数可以导致一些闪烁。
也可以参考removeWidget()。
void QStatusBar::clear () [槽]
移除正在被显示的任何临时的消息。
也可以参考message()。
void QStatusBar::hideOrShow () [保护]
确保右面的窗口部件是可视的。被message()和clear()使用。bool QStatusBar::isSizeGripEnabled () const
如果在状态条右下方的QSizeGrip是生效的,返回真,否则返回假。详细情况请参考“sizeGripEnabled”属性。
void QStatusBar::message ( const QString & message ) [槽]
隐藏正常状态指示器并且显示message,直到clear()或者另一个message()被调用。
也可以参考clear()。
void QStatusBar::message ( const QString & message, int ms ) [槽]
这是一个重载成员函数,提供了方便。它的行为基本上和上面的函数相同。隐藏正常状态指示器并且显示messagems毫秒,或者直到clear()或者另一个message()被调用,看哪一个先发生了。
void QStatusBar::paintEvent ( QPaintEvent * ) [虚 保护]
如果适当,显示临时的消息。从QWidget中重新实现。
void QStatusBar::reformat () [保护]
改变状态条的外观来说明项的变化。特殊的子类可能需要这个,但是几何形状管理将通常要注意任何需要的重新整理。void QStatusBar::removeWidget ( QWidget * widget ) [虚]
从状态条中移除widget。这个函数可能导致一些闪烁。
注意widget没有被删除。
也可以参考addWidget()。
void QStatusBar::setSizeGripEnabled ( bool )
设置在状态条右下方的QSizeGrip是否生效。详细情况请参考“sizeGripEnabled”属性。
属性文档
bool sizeGripEnabled
这个属性保存的是在状态条右下方的QSizeGrip是否有效。
可以让状态条右下方的QSizeGrip生效或者失效。默认它是生效的。
通过setSizeGripEnabled()设置属性值并且通过isSizeGripEnabled()来获得属性值。
这个文件是Qt工具包一部分。 版权所有 © 1995-2002 Trolltech。保留所有权利。
Copyright © 2002 Trolltech | Trademarks | 译者:Cavendish | Qt 3.0.5版
|