PySide6.QtWidgets.QProgressBar¶
- class QProgressBar¶
QProgressBar
小部件提供了一个水平或垂直的进度条。更多…概要¶
属性¶
alignmentᅟ
- 进度条的对齐方式formatᅟ
- 用于生成当前文本的字符串invertedAppearanceᅟ
- 进度条是否显示其进度反转maximumᅟ
- 进度条的最大值minimumᅟ
- 进度条的最小值orientationᅟ
- 进度条的方向textᅟ
- 进度条旁边显示的描述性文本textDirectionᅟ
- 垂直进度条的文本阅读方向textVisibleᅟ
- 是否应显示当前完成的百分比valueᅟ
- 进度条的当前值
方法¶
def
__init__()
def
alignment()
def
format()
def
isTextVisible()
def
maximum()
def
minimum()
def
orientation()
def
resetFormat()
def
setAlignment()
def
setFormat()
def
setTextVisible()
def
textDirection()
def
value()
虚拟方法¶
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下载项目时,如果无法确定正在下载的项目的大小。
另请参阅
- class Direction¶
指定垂直进度条的
text
的阅读方向。常量
描述
QProgressBar.TopToBottom
文本顺时针旋转90度。
QProgressBar.BottomToTop
文本逆时针旋转90度。
请注意,文本是否被绘制取决于样式。目前,CleanLooks 和 Plastique 样式会绘制文本。而 Mac、Windows 和 WindowsVista 样式则不会。
另请参阅
注意
当使用
from __feature__ import true_property
时,属性可以直接使用,否则通过访问器函数使用。- property alignmentᅟ: Combination of Qt.AlignmentFlag¶
此属性保存进度条的对齐方式。
- Access functions:
- property formatᅟ: str¶
此属性保存用于生成当前文本的字符串。
%p - 被完成的百分比替换。%v - 被当前值替换。%m - 被总步骤数替换。
默认值为“%p%”。
另请参阅
- 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 从不绘制文本)。
另请参阅
- Access functions:
- property valueᅟ: int¶
此属性保存进度条的当前值。
尝试将当前值更改为超出最小-最大范围的值对当前值没有影响。
- Access functions:
使用给定的
parent
构建一个进度条。默认情况下,最小步长值设置为0,最大步长值设置为100。
另请参阅
- alignment()¶
- Return type:
AlignmentFlag
的组合
另请参阅
属性
alignmentᅟ
的获取器。- format()¶
- Return type:
字符串
另请参阅
属性
formatᅟ
的获取器。- initStyleOption(option)¶
- Parameters:
使用此
QProgressBar
中的值初始化option
。当子类需要QStyleOptionProgressBar
但不想自己填写所有信息时,此方法非常有用。另请参阅
- invertedAppearance()¶
- Return type:
布尔
属性
invertedAppearanceᅟ
的获取器。- isTextVisible()¶
- Return type:
布尔
属性
textVisibleᅟ
的获取器。- maximum()¶
- Return type:
整数
另请参阅
属性
maximumᅟ
的获取器。- minimum()¶
- Return type:
整数
另请参阅
属性
minimumᅟ
的获取器。- orientation()¶
- Return type:
另请参阅
属性
orientationᅟ
的获取器。- reset()¶
重置进度条。进度条“回退”并显示无进度。
- resetFormat()¶
属性
formatᅟ
的重置功能。- setAlignment(alignment)¶
- Parameters:
alignment –
AlignmentFlag
的组合
另请参阅
属性
alignmentᅟ
的设置器。属性
formatᅟ
的设置器。- setInvertedAppearance(invert)¶
- Parameters:
invert – 布尔值
另请参阅
属性
invertedAppearanceᅟ
的设置器。属性
maximumᅟ
的设置器。属性
minimumᅟ
的设置器。- setOrientation(arg__1)¶
- Parameters:
arg__1 –
Orientation
另请参阅
属性
orientationᅟ
的设置器。- setRange(minimum, maximum)¶
- Parameters:
minimum – int
maximum – 整数
将进度条的最小值和最大值分别设置为
minimum
和maximum
。如果
maximum
小于minimum
,minimum
将成为唯一合法的值。如果当前值超出新范围,进度条将使用
reset()
重置。可以通过使用setRange(0, 0)将
QProgressBar
设置为不确定状态。属性
textDirectionᅟ
的设置器。- setTextVisible(visible)¶
- Parameters:
visible – 布尔值
另请参阅
属性
textVisibleᅟ
的设置器。属性
valueᅟ
的设置器。- text()¶
- Return type:
字符串
属性
textᅟ
的获取器。- textDirection()¶
- Return type:
另请参阅
属性
textDirectionᅟ
的获取器。- value()¶
- Return type:
整数
另请参阅
属性
valueᅟ
的获取器。- valueChanged(value)¶
- Parameters:
值 – int
当进度条中显示的值发生变化时,会发出此信号。
value
是进度条显示的新值。属性
valueᅟ
的通知信号。