QStatusBar类

本文主要是介绍QStatusBar类，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

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()来获得属性值。

这篇关于QStatusBar类的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！

---