PySide6.QtWidgets.QProgressBar¶

class QProgressBar¶

QProgressBar 小部件提供了一个水平或垂直的进度条。更多…

概要¶

属性¶

• alignmentᅟ - 进度条的对齐方式

• formatᅟ - 用于生成当前文本的字符串

• invertedAppearanceᅟ - 进度条是否显示其进度反转

• maximumᅟ - 进度条的最大值

• minimumᅟ - 进度条的最小值

• orientationᅟ - 进度条的方向

• textᅟ - 进度条旁边显示的描述性文本

• textDirectionᅟ - 垂直进度条的文本阅读方向

• textVisibleᅟ - 是否应显示当前完成的百分比

• valueᅟ - 进度条的当前值

方法¶

• def __init__()

• def alignment()

• def format()

• def invertedAppearance()

• def isTextVisible()

• def maximum()

• def minimum()

• def orientation()

• def resetFormat()

• def setAlignment()

• def setFormat()

• def setInvertedAppearance()

• def setTextDirection()

• def setTextVisible()

• def textDirection()

• def value()

虚拟方法¶

• def initStyleOption()

• def text()

插槽¶

• def reset()

• def setMaximum()

• def setMinimum()

• def setOrientation()

• def setRange()

• def setValue()

信号¶

• def valueChanged()

注意

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

详细描述¶

进度条用于向用户指示操作的进度，并确保他们知道应用程序仍在运行。

进度条使用了步骤的概念。您通过指定最小和最大可能的步骤值来设置它，当您稍后提供当前步骤值时，它将显示已完成步骤的百分比。百分比是通过将进度（value() - minimum()）除以maximum() - minimum()来计算的。

您可以使用setMinimum()和setMaximum指定步骤的最小值和最大值。当前步骤数通过setValue()设置。进度条可以通过reset()重置到开始位置。

如果最小值和最大值都设置为0，进度条将显示一个忙碌指示器，而不是步骤的百分比。这在某些情况下非常有用，例如，当使用QNetworkAccessManager下载项目时，如果无法确定正在下载的项目的大小。

另请参阅

QProgressDialog

class Direction¶

指定垂直进度条的text的阅读方向。

常量	描述
QProgressBar.TopToBottom	文本顺时针旋转90度。
QProgressBar.BottomToTop	文本逆时针旋转90度。

请注意，文本是否被绘制取决于样式。目前，CleanLooks 和 Plastique 样式会绘制文本。而 Mac、Windows 和 WindowsVista 样式则不会。

另请参阅

textDirection

注意

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

property alignmentᅟ: Combination of Qt.AlignmentFlag¶

此属性保存进度条的对齐方式。

Access functions:

• alignment()

• setAlignment()

property formatᅟ: str¶

此属性保存用于生成当前文本的字符串。

%p - 被完成的百分比替换。%v - 被当前值替换。%m - 被总步骤数替换。

默认值为“%p%”。

另请参阅

text()

Access functions:

• format()

• setFormat()

• resetFormat()

property invertedAppearanceᅟ: bool¶

此属性用于确定进度条是否显示其进度为倒置。

如果此属性为 true，进度条将向相反方向增长（例如从右到左）。默认情况下，进度条不会反转。

另请参阅

orientation layoutDirection

Access functions:

• invertedAppearance()

• setInvertedAppearance()

property maximumᅟ: int¶

此属性保存进度条的最大值。

设置此属性时，如有必要，将调整minimum以确保范围保持有效。如果当前值超出新范围，进度条将通过reset()重置。

Access functions:

• maximum()

• setMaximum()

property minimumᅟ: int¶

此属性保存进度条的最小值。

设置此属性时，如有必要，将调整maximum以确保范围保持有效。如果当前值超出新范围，进度条将使用reset()重置。

Access functions:

• minimum()

• setMinimum()

property orientationᅟ: Qt.Orientation¶

此属性表示进度条的方向。

方向必须是 Qt::Horizontal（默认）或 Qt::Vertical。

另请参阅

invertedAppearance textDirection

Access functions:

• orientation()

• setOrientation()

property textᅟ: str¶

此属性保存与进度条一起显示的描述性文本。

返回的文本与进度条中心（或某些样式中，左侧）显示的文本相同。

文本中显示的进度可能小于最小值，表示进度条在设置任何进度之前处于“重置”状态。

在默认实现中，文本要么包含一个表示当前进度的百分比值，要么为空，因为进度条处于重置状态。

Access functions:

• text()

property textDirectionᅟ: QProgressBar.Direction¶

此属性用于垂直进度条的text的阅读方向。

此属性对水平进度条没有影响。默认情况下，阅读方向为TopToBottom。

另请参阅

orientation textVisible

Access functions:

• textDirection()

• setTextDirection()

property textVisibleᅟ: bool¶

此属性保存是否应显示当前完成的百分比。

此属性可能会被样式忽略（例如，QMacStyle 从不绘制文本）。

另请参阅

textDirection

Access functions:

• isTextVisible()

• setTextVisible()

property valueᅟ: int¶

此属性保存进度条的当前值。

尝试将当前值更改为超出最小-最大范围的值对当前值没有影响。

Access functions:

• value()

• setValue()

• 信号 valueChanged()

__init__([parent=None])¶

Parameters:

父级 – QWidget

使用给定的parent构建一个进度条。

默认情况下，最小步长值设置为0，最大步长值设置为100。

另请参阅

setRange()

alignment()¶

Return type:

AlignmentFlag 的组合

另请参阅

setAlignment()

属性 alignmentᅟ 的获取器。

format()¶

Return type:

字符串

另请参阅

setFormat()

属性 formatᅟ 的获取器。

initStyleOption(option)¶

Parameters:

选项 – QStyleOptionProgressBar

使用此QProgressBar中的值初始化option。当子类需要QStyleOptionProgressBar但不想自己填写所有信息时，此方法非常有用。

另请参阅

initFrom()

invertedAppearance()¶

Return type:

布尔

另请参阅

setInvertedAppearance()

属性 invertedAppearanceᅟ 的获取器。

isTextVisible()¶

Return type:

布尔

属性 textVisibleᅟ 的获取器。

maximum()¶

Return type:

整数

另请参阅

setMaximum()

属性 maximumᅟ 的获取器。

minimum()¶

Return type:

整数

另请参阅

setMinimum()

属性 minimumᅟ 的获取器。

orientation()¶

Return type:

方向

另请参阅

setOrientation()

属性 orientationᅟ 的获取器。

reset()¶

重置进度条。进度条“回退”并显示无进度。

resetFormat()¶

属性formatᅟ的重置功能。

setAlignment(alignment)¶

Parameters:

alignment – AlignmentFlag 的组合

另请参阅

alignment()

属性 alignmentᅟ 的设置器。

setFormat(format)¶

Parameters:

format – str

另请参阅

format()

属性 formatᅟ 的设置器。

setInvertedAppearance(invert)¶

Parameters:

invert – 布尔值

另请参阅

invertedAppearance()

属性 invertedAppearanceᅟ 的设置器。

setMaximum(maximum)¶

Parameters:

最大值 – int

另请参阅

maximum()

属性 maximumᅟ 的设置器。

setMinimum(minimum)¶

Parameters:

最小值 – int

另请参阅

minimum()

属性 minimumᅟ 的设置器。

setOrientation(arg__1)¶

Parameters:

arg__1 – Orientation

另请参阅

orientation()

属性 orientationᅟ 的设置器。

setRange(minimum, maximum)¶

Parameters:

• minimum – int

• maximum – 整数

将进度条的最小值和最大值分别设置为minimum和maximum。

如果 maximum 小于 minimum，minimum 将成为唯一合法的值。

如果当前值超出新范围，进度条将使用reset()重置。

可以通过使用setRange(0, 0)将QProgressBar设置为不确定状态。

另请参阅

minimum maximum

setTextDirection(textDirection)¶

Parameters:

textDirection – Direction

另请参阅

textDirection()

属性 textDirectionᅟ 的设置器。

setTextVisible(visible)¶

Parameters:

visible – 布尔值

另请参阅

isTextVisible()

属性 textVisibleᅟ 的设置器。

setValue(value)¶

Parameters:

值 – int

另请参阅

value()

属性 valueᅟ 的设置器。

text()¶

Return type:

字符串

属性 textᅟ 的获取器。

textDirection()¶

Return type:

方向

另请参阅

setTextDirection()

属性 textDirectionᅟ 的获取器。

value()¶

Return type:

整数

另请参阅

setValue()

属性 valueᅟ 的获取器。

valueChanged(value)¶

Parameters:

值 – int

当进度条中显示的值发生变化时，会发出此信号。value 是进度条显示的新值。

属性 valueᅟ 的通知信号。