QprogressBar 类
Detailed Description – 内容描述

进度条用于向用户指示操作的进度,并向用户保证应用程序仍在运行。
进度栏steps的概念。 您可以通过指定最小和最大可能的步长值来进行设置,当您稍后为其提供当前步长值时,它将显示已完成的步长百分比。 百分比是通过将进度(value()-minimum())除以maximum()-minimum()来计算的。
您可以使用setMinimum()和setMaximum指定最小和最大步数。 当前的步数由setValue()设置。 可以使用reset()将进度条倒退到开头。

如果最小和最大值都设置为0,则该条显示忙碌指示符,而不是步进百分比。 例如,当无法确定要下载的项目的大小时,使用QNetworkAccessManager下载项目时,这很有用。

另请参见QProgressDialog和GUI Design Handbook: Progress Indicator

Properties – 属性
alignment : Qt::Alignment
他的属性保持进度条的对齐
访问函数:
Qt::Alignment alignment() const
void setAlignment(Qt::Alignment aligment)
Public Functions – 公共函数
QProgressBar::QProgressBar(QWidget *parent = nullptr)
用给定的parent构造进度条。
默认情况下,最小步长值设置为0,最大步长设置为100。
另请参见setRange()。

QProgressBar::~QProgressBar()
析构函数。

alignment : Qt::Alignment
此属性保存进度条的对齐方式。
访问函数:
Qt::Aligment alignment() const
void setAlignment(Qt::Alignment alignment)
format : QString
此属性保存用于生成当前文本的字符串
%p-用完成的百分比代替。 %v-由当前值替换。 %m-由总步数代替。
默认值为“%p%”。
此属性在Qt 4.2中引入。
访问函数:
QString format() const
void setFormat(const QString & format)
void resetFormat()
另请参见text()。

invertedAppearance : bool
此属性保存进度条是否显示其进度反转
如果此属性为true,则进度条会朝另一个方向(例如,从右到左)增长。 默认情况下,进度条不反转。
此属性在Qt 4.1中引入。
访问函数:
bool invertedAppearence
void setInvertedAppearance(bool invert)
另请参见orientation和layoutDirection。

textVisible : bool
此属性保存是否应显示当前完成的百分比
样式可能会忽略此属性(例如,QMacStyle永远不会绘制文本)。
访问函数:
bool isTextVisible() const
void setTextVisible(cool visible)
另请参见textDirection。

maximum : int
此属性保存进度条的最大值
设置此属性时,如有必要,将调整最小值,以确保范围保持有效。 如果当前值不在新范围内,则使用reset()重置进度条。
访问函数:
int maximum() const
void setMaximum (int maximum)

minimum : int
此属性保存进度条的最小值
设置此属性时,如有必要,将调整最大值以确保范围保持有效。 如果当前值不在新范围内,则使用reset()重置进度条。
访问函数:
int minimum() const
void setMinimum(int minimum)

orientation : Qt::Orientation
此属性保存进度条的方向
方向必须是Qt :: Horizontal(默认)或Qt :: Vertical。
此属性在Qt 4.1中引入。
访问函数:
Qt::Orientation orientation() const
void setPrientation(Qt::Orientation)
另请参见verticalAppearance和textDirection。

textDirection : Direction
此属性保存垂直进度条的文本阅读方向
此属性对水平进度条没有影响。 默认情况下,读取方向为QProgressBar :: TopToBottom。
此属性在Qt 4.1中引入。
访问函数:
QprogressBar::Direction textDirection() const
void setTextDiretion(QprogressBar::DirectiontextDiretion)
另请参阅方向和textVisible。

text : const QString
该属性保存进度条显示的描述性文本
返回的文本与进度条中心(或某些样式的左侧)中显示的文本相同。
文本中显示的进度可能小于最小值,表示进度条在设置任何进度之前处于“重置”状态。
在默认实现中,文本或者包含指示到目前为止的进度的百分比值,或者由于进度条处于重置状态而为空白。
访问函数:
virtual QString text() const

value : int
此属性保存进度条的当前值
尝试将当前值更改为最小最大范围之外的值不会影响当前值。
访问函数:
int value() const
void setValue(int value)

Public Slots – 公共插槽
void QProgressBar::reset()
重置进度栏。 进度栏“倒带”,并且没有进度。

maximum : int
此属性保存进度条的最大值
设置此属性时,如有必要,将调整最小值,以确保范围保持有效。 如果当前值不在新范围内,则使用reset()重置进度条。
访问函数:
int maximum() const
void setMaximum (int maximum)

minimum : int
此属性保存进度条的最小值
设置此属性时,如有必要,将调整最大值以确保范围保持有效。 如果当前值不在新范围内,则使用reset()重置进度条。
访问函数:
int minimum() const
void setMinimum(int minimum)

orientation : Qt::Orientation
此属性保存进度条的方向
方向必须是Qt :: Horizontal(默认)或Qt :: Vertical。
此属性在Qt 4.1中引入。
访问函数:
Qt::Orientation orientation() const
void setPrientation(Qt::Orientation)
另请参见verticalAppearance和textDirection。

void QProgressBar::setRange(int minimum, int maximum)
将进度条的最小值和最大值分别设置为minimum和maximum。
如果maximum小于minimum,则minimum成为唯一合法值。
如果当前值不在新范围内,则使用reset()重置进度条。
可以使用setRange(0,0)将QProgressBar设置为不确定状态。
另请参见minimum和maximum。

value : int
此属性保存进度条的当前值
尝试将当前值更改为最小最大范围之外的值不会影响当前值。
访问函数:
int value() const
void setValue(int value)
Protected Functions – 保护函数
void QProgressBar::initStyleOption(QStyleOptionProgressBar *option) const
使用此QProgressBar中的值初始化选项。 当子类需要QStyleOptionProgressBar但又不想自己填写所有信息时,此方法很有用。
另请参见QStyleOption :: initFrom()。

Leave a Comment