PySide6.QtWidgets.QStatusBar

class QStatusBar

QStatusBar 类提供了一个适合显示状态信息的水平条。更多…

PySide6.QtWidgets.QStatusBar 的继承图

概要

属性

方法

插槽

信号

注意

本文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译问题，您也可以通过在我们的https:/bugreports.qt.io/projects/PYSIDE上创建工单来告知我们。

详细描述

警告

本节包含从C++自动翻译到Python的代码片段，可能包含错误。

每个状态指示器属于以下三个类别之一：

  • 临时 - 短暂占据状态栏的大部分空间。例如，用于解释工具提示文本或菜单项。

  • 正常 - 占据状态栏的一部分，可能会被临时消息隐藏。例如，用于在文字处理软件中显示页面和行号。

  • 永久 - 永远不会隐藏。用于重要的模式指示，例如，一些应用程序在状态栏中放置了一个大写锁定指示器。

QStatusBar 允许您显示所有三种类型的指示器。

通常，状态栏功能的请求与QMainWindow对象相关。QMainWindow提供了一个主应用程序窗口，包含菜单栏、工具栏、停靠部件以及围绕大型中央部件的状态栏。可以使用statusBar()函数检索状态栏，并使用setStatusBar()函数替换它。

使用 showMessage() 插槽来显示一条临时消息：

statusBar().showMessage(tr("Ready"))

要移除临时消息，请使用 clearMessage() 插槽，或在调用 showMessage() 时设置时间限制。例如：

statusBar().showMessage(tr("Ready"), 2000)

使用currentMessage()函数来检索当前显示的临时消息。QStatusBar类还提供了messageChanged()信号，每当临时状态消息发生变化时，该信号就会被发出。

普通和永久消息通过创建一个小部件（QLabel、QProgressBar 或甚至 QToolButton）然后使用 addWidget() 或 addPermanentWidget() 函数将其添加到状态栏来显示。使用 removeWidget() 函数从状态栏中移除此类消息。

statusBar().addWidget(MyReadWriteIndication())

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

注意

当使用from __feature__ import true_property时，属性可以直接使用，否则通过访问器函数使用。

property sizeGripEnabledᅟ: bool

此属性表示状态栏右下角的QSizeGrip是否启用。

默认情况下，大小调整手柄是启用的。

Access functions:
__init__([parent=None])
Parameters:

父级 – QWidget

构建一个带有大小调整手柄和给定parent的状态栏。

另请参阅

setSizeGripEnabled()

addPermanentWidget(widget[, stretch=0])
Parameters:

  • widget – QWidget

  • stretch – int

将给定的widget永久添加到此状态栏，如果该部件尚未成为此QStatusBar对象的子部件，则重新设置其父部件。stretch参数用于在状态栏增长和缩小时计算给定widget的合适大小。默认的拉伸因子为0，即为部件提供最小的空间。

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

addWidget(widget[, stretch=0])
Parameters:

  • widget – QWidget

  • stretch – int

将给定的widget添加到此状态栏中，如果该部件尚未成为此QStatusBar对象的子部件，则重新设置其父部件。stretch参数用于在状态栏增长和缩小时计算给定widget的合适大小。默认的拉伸因子为0，即为部件提供最小的空间。

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

clearMessage()

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

currentMessage()
Return type:

字符串

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

另请参阅

showMessage()

hideOrShow()

确保正确的部件可见。

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

insertPermanentWidget(index, widget[, stretch=0])
Parameters:

  • index – 整数

  • widget – QWidget

  • stretch – int

Return type:

整数

将给定的widget永久插入到状态栏的指定index位置，如果该部件还不是此QStatusBar对象的子部件，则重新设置其父部件。如果index超出范围，部件将被追加（在这种情况下，返回的是部件的实际索引）。

stretch 参数用于在状态栏增长和缩小时计算给定 widget 的合适大小。默认的拉伸因子为 0，即为小部件提供最小的空间。

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

insertWidget(index, widget[, stretch=0])
Parameters:

  • index – 整数

  • widget – QWidget

  • stretch – int

Return type:

整数

将给定的widget插入到给定的index处，如果该部件还不是此QStatusBar对象的子部件，则重新设置其父部件。如果index超出范围，部件将被追加（在这种情况下，返回的是部件的实际索引）。

stretch 参数用于在状态栏增长和缩小时计算给定 widget 的合适大小。默认的拉伸因子为 0，即为小部件提供最小的空间。

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

isSizeGripEnabled()
Return type:

布尔

属性 sizeGripEnabledᅟ 的获取器。

messageChanged(text)
Parameters:

文本 – str

每当临时状态消息发生变化时，都会发出此信号。新的临时消息通过message参数传递，当消息被移除时，该参数为空字符串。

reformat()

更改状态栏的外观以反映项目的变化。

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

removeWidget(widget)
Parameters:

widget – QWidget

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

注意

此函数不会删除小部件，而是隐藏它。要再次添加小部件，您必须调用addWidget()和show()函数。

另请参阅

addWidget() addPermanentWidget() clearMessage()

setSizeGripEnabled(arg__1)
Parameters:

arg__1 – 布尔值

另请参阅

isSizeGripEnabled()

属性 sizeGripEnabledᅟ 的设置器。

showMessage(text[, timeout=0])
Parameters:

  • 文本 – str

  • timeout – int

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

请注意，调用showMessage()是为了显示工具提示文本的临时解释，因此传递timeout为0不足以显示永久 消息。