QStatusBar 类

statusBar()->showMessage(tr("Ready"));

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

statusBar()->addWidget(new MyReadWriteIndication);

成员函数文档

[明确] QStatusBar::QStatusBar(QWidget *parent = nullptr)

使用给定 parent 构造一个具有大小控制柄的状态栏。

另请参阅setSizeGripEnabled。

[虚函数 noexcept] QStatusBar::~QStatusBar()

销毁此状态栏并释放任何分配的资源及其子部件。

void QStatusBar::addPermanentWidget(QWidget *widget, int stretch = 0)

将指定的 widget 永久添加到状态栏中，如果该部件还不是此 QStatusBar 对象的子项，会将其重置为子项。使用 stretch 参数来计算状态栏增长和缩小时给定 widget 的合适大小。默认缩放因子为 0，即给部件最小的空间。

永久性意味着小部件可能不会被临时消息遮挡。它位于状态栏的右侧。

见亦 insertPermanentWidget()，removeWidget()，以及 addWidget()。

void QStatusBar::addWidget(QWidget *widget，int stretch = 0)

将指定的widget添加到状态栏中，如果该小部件还不是状态栏对象QStatusBar的子对象时，将其重新父化。参数<浓郁>stretch用于在状态栏增长和缩小过程中为指定的<浓郁>widget计算一个合适的大小。默认的扩展因子是0，即给予小部件最小的空间。

小部件位于第一个永久小部件（见addPermanentWidget()）的左侧，可能被临时消息遮挡。

见亦 insertWidget()，removeWidget()，以及 addPermanentWidget()。

[slot] void QStatusBar::clearMessage()

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

见亦 currentMessage()，showMessage()，以及removeWidget()。

QString QStatusBar::currentMessage() const

返回当前显示的临时消息，如果没有任何此类消息，则返回空字符串。

见亦 showMessage()。

[override virtual protected] bool QStatusBar::event(QEvent *e)

重新实现： QWidget::event(QEvent *event)。

[protected] void QStatusBar::hideOrShow()

确保正确的工具是可见的。

被showMessage()和clearMessage()函数使用。

int QStatusBar::insertPermanentWidget(int index，QWidget *widget，int stretch = 0)

将给定的小部件永久地插入状态栏的给定索引，如果小部件还不是状态栏对象QStatusBar的子对象时，将其重新父化。如果索引超出范围，则将小部件附加（在这种情况下，返回的是小部件的实际索引）。

参数<浓郁>stretch用于在状态栏增长和缩小过程中为给定的小部件计算一个合适的大小。默认的扩展因子是0，即给予小部件最小的空间。

永久性意味着小部件可能不会被临时消息遮挡。它位于状态栏的右侧。

见亦 addPermanentWidget()，removeWidget()，以及:addWidget()。

int QStatusBar::insertWidget(int index，QWidget *widget，int stretch = 0)

将指定的 widget 插入到指定的 索引 处，如果该 widget 还不是本 QStatusBar 对象的子对象，则会重新将 widget 作为子对象。如果 索引 在范围之外，则将 widget 添加到末尾（在这种情况下返回的实际上是 widget 的实际索引）。

参数<浓郁>stretch用于在状态栏增长和缩小过程中为给定的小部件计算一个合适的大小。默认的扩展因子是0，即给予小部件最小的空间。

小部件位于第一个永久小部件（见addPermanentWidget()）的左侧，可能被临时消息遮挡。

另请参阅：addWidget()，removeWidget() 和 addPermanentWidget()。

[signal] void QStatusBar::messageChanged(const QString &message)

每次临时状态消息改变时，都会发射此信号。新的临时消息作为参数传入 message，当消息被移除时，message 是空字符串。

另请参阅：showMessage() 和 clearMessage()。

[override virtual protected] void QStatusBar::paintEvent(QPaintEvent *event)

重实现了：QWidget::paintEvent(QPaintEvent *event)。

根据绘制事件，如果适当，显示临时消息。

[protected] void QStatusBar::reformat()

根据项目更改更改状态栏的外观。

特殊子类可能需要此函数，但通常几何管理会负责任何必要的重新排列。

void QStatusBar::removeWidget(QWidget *widget)

从状态栏中移除指定的 widget。

另请参阅：addWidget()，addPermanentWidget() 和 clearMessage()。

[override virtual protected] void QStatusBar::resizeEvent(QResizeEvent *e)

重实现了：QWidget::resizeEvent(QResizeEvent *event)。

[override virtual protected] void QStatusBar::showEvent(QShowEvent *)

重实现了：QWidget::showEvent(QShowEvent *event)。

[slot] void QStatusBar::showMessage(const QString &message, int timeout = 0)

在指定的毫秒数 (timeout) 内隐藏正常状态提示并显示给定的 message。如果 timeout 为 0（默认值），则 message 将保持显示，直到调用 clearMessage() 信号或再次调用 showMessage() 信号以更改消息。

请注意，调用了showMessage()来显示工具提示文本的临时解释，因此传递一个超时为0是不够的，无法显示一个永久的消息。

另请参阅messageChanged()，currentMessage()和clearMessage()。