PySide6.QtWidgets.QProgressBar

class QProgressBar

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

PySide6.QtWidgets.QProgressBar 的继承图

概要

属性

方法

虚拟方法

插槽

信号

注意

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

详细描述

../../_images/fusion-progressbar.png

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

进度条使用了步骤的概念。您通过指定最小和最大可能的步骤值来设置它,当您稍后提供当前步骤值时,它将显示已完成步骤的百分比。百分比是通过将进度(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:
property formatᅟ: str

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

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

默认值为“%p%”。

另请参阅

text()

Access functions:
property invertedAppearanceᅟ: bool

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

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

Access functions:
property maximumᅟ: int

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

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

Access functions:
property minimumᅟ: int

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

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

Access functions:
property orientationᅟ: Qt.Orientation

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

方向必须是 Qt::Horizontal(默认)或 Qt::Vertical。

Access functions:
property textᅟ: str

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

返回的文本与进度条中心(或某些样式中,左侧)显示的文本相同。

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

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

Access functions:
property textDirectionᅟ: QProgressBar.Direction

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

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

另请参阅

orientation textVisible

Access functions:
property textVisibleᅟ: bool

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

此属性可能会被样式忽略(例如,QMacStyle 从不绘制文本)。

另请参阅

textDirection

Access functions:
property valueᅟ: int

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

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

Access functions:
__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:

布尔

属性 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:

alignmentAlignmentFlag 的组合

另请参阅

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__1Orientation

另请参阅

orientation()

属性 orientationᅟ 的设置器。

setRange(minimum, maximum)
Parameters:
  • minimum – int

  • maximum – 整数

将进度条的最小值和最大值分别设置为minimummaximum

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

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

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

另请参阅

minimum maximum

setTextDirection(textDirection)
Parameters:

textDirectionDirection

另请参阅

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ᅟ 的通知信号。