class QProgressBar

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

概述

属性

• alignment - 进步条的对齐方式

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

• invertedAppearance - 进步条是否逆序显示进度

• maximum - 进步条的最大值

• minimum - 进步条的最小值

• orientation - 进步条的方向

• text - 与进步条一起显示的描述性文本

• textDirection - 垂直进步条中文本的阅读方向

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

• value - 进步条当前值

方法

• 定义 __init__()

• 定义 alignment()

• 定义 format()

• 定义 invertedAppearance()

• 定义 isTextVisible()

• 定义 maximum()

• 定义 minimum()

• 定义 orientation()

• 定义 resetFormat()

• 定义 setAlignment()

• 定义 setFormat()

• 定义 setInvertedAppearance()

• 定义 setTextDirection()

• 定义 setTextVisible()

• 定义 textDirection()

• 定义 value()

虚拟方法

• 定义 initStyleOption()

• 定义 text()

槽函数

• 定义 reset()

• 定义 setMaximum()

• 定义 setMinimum()

• 定义 setOrientation()

• 定义 setRange()

• 定义 setValue()

信号

• 定义 valueChanged()

注意

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

详细描述

进度条用于告知用户操作的进度，并让他们放心应用仍在运行。

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

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

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

另见

QProgressDialog

类 Direction

指定垂直进度条文本的读取方向。

常数	描述
QProgressBar.TopToBottom	文本按顺时针方向旋转90度。
QProgressBar.BottomToTop	文本按逆时针方向旋转90度。

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

另见

textDirection

注意

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

属性 alignment: Qt.AlignmentFlag 的组合#

此属性包含进度条的居中方式。

访问函数

• alignment()

• setAlignment()

属性 format: str#

此属性包含生成当前文本所使用的字符串。

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

默认值为 “%p%”。

另见

text()

访问函数

• format()

• setFormat()

• resetFormat()

属性 invertedAppearance: bool#

此属性表示进度条是否以反转的方式显示进度。

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

另见

orientation layoutDirection

访问函数

• invertedAppearance()

• setInvertedAppearance()

属性 maximum: int#

此属性包含进度条的最大值。

设置此属性时，如果需要，将调整 minimum 以确保范围有效。如果当前值超出新的范围，则使用 reset 重置进度条。

访问函数

• maximum()

• setMaximum()

属性 minimum: int#

此属性包含进度条的最小值。

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

访问函数

• minimum()

• setMinimum()

属性 orientation: Qt.Orientation#

此属性包含进度条的排列方向。

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

另见

invertedAppearance textDirection

访问函数

• orientation()

• setOrientation()

属性text: str

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

返回的文本与在进度条中心（或某些风格中在左侧）显示的文本相同。

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

在默认实现中，文本包含表示到目前为止进度的百分比值，或者为空，因为进度条处于重置状态。

访问函数

• text()

属性textDirection: QProgressBar.Direction

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

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

另见

orientation textVisible

访问函数

• textDirection()

• setTextDirection()

属性textVisible: bool

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

此属性可能会被风格忽略（例如，QMacStyle永远不会绘制文本）。

另见

textDirection

访问函数

• isTextVisible()

• setTextVisible()

属性value: int

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

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

访问函数

• value()

• setValue()

• 信号 valueChanged

__init__([parent=None])

参数：

parent – QWidget

通过给定的 parent 构建一个进度条。

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

另见

setRange()

alignment()

返回类型：

AlignmentFlag 的组合

另见

setAlignment()

属性 alignmentᅟ 的获取器。

format()

返回类型：

str

另见

setFormat()

属性 formatᅟ 的获取器。

initStyleOption(option)

参数：

option – QStyleOptionProgressBar

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

另见

initFrom()

invertedAppearance()

返回类型：

bool

另见

setInvertedAppearance()

属性 invertedAppearanceᅟ 的获取器。

isTextVisible()

返回类型：

bool

属性 textVisibleᅟ 的获取器。

maximum()

返回类型：

int

另见

setMaximum()

属性 maximumᅟ 的获取器。

minimum()

返回类型：

int

另见

setMinimum()

属性 minimumᅟ 的获取器。

orientation()

返回类型：

Orientation

另见

setOrientation()

属性 orientationᅟ 的获取器。

reset()

重置进度条。进度条“倒带”，显示没有进度。

resetFormat()

重置属性 format属性 的函数。

setAlignment(alignment)

参数：

alignment – AlignmentFlag 的组合

另见

alignment()

alignment属性 的设置器。

setFormat(format)

参数：

format – str

另见

format()

format属性 的设置器。

setInvertedAppearance(invert)

参数：

invert – bool

另见

invertedAppearance()

invertedAppearance属性 的设置器。

setMaximum(maximum)

参数：

maximum – int

另见

maximum()

maximum属性 的设置器。

setMinimum(minimum)

参数：

minimum – int

另见

minimum()

minimum属性 的设置器。

setOrientation(arg__1)

参数：

arg__1 – Orientation

另见

orientation()

orientation属性 的设置器。

setRange(minimum, maximum)

参数：

• minimum – int

• maximum – int

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

如果 最大值 小于 最小值，则 最小值 成为唯一的合法值。

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

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

另见

minimum maximum

setTextDirection(textDirection)

参数：

textDirection – Direction

另见

textDirection()

属性 textDirection 的设置器。

setTextVisible(visible)

参数：

visible – 布尔值

另见

isTextVisible()

属性 textVisible 的设置器。

setValue(value)

参数：

value – int

另见

value()

属性 value 的设置器。

text()

返回类型：

str

属性 text 的获取器。

textDirection()

返回类型：

Direction

另见

setTextDirection()

属性 textDirection 的获取器。

value()

返回类型：

int

另见

setValue()

属性 value 的获取器。

valueChanged(value)

参数：

value – int

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

属性 value 的通知信号。