内容

• 公共类型
• 特性
• 公共函数
• 重实现公共函数
• 公共槽
• 信号
• 保护函数
• 重实现保护函数
• 详细描述

QProgressBar 类

QProgressBar 小部件提供水平 (或垂直) 进度条。 更多...

头：	#include <QProgressBar>
qmake:	QT += widgets
继承：	QWidget

• 所有成员列表，包括继承成员

公共类型

enum	Direction { TopToBottom, BottomToTop }

特性

alignment : Qt::Alignment format : QString invertedAppearance : bool maximum : int minimum : int

orientation : Qt::Orientation text : const QString textDirection : Direction textVisible : bool value : int

公共函数

	QProgressBar (QWidget * parent = nullptr)
virtual	~QProgressBar ()
Qt::Alignment	alignment () const
QString	format () const
bool	invertedAppearance () const
bool	isTextVisible () const
int	maximum () const
int	minimum () const
Qt::Orientation	orientation () const
void	resetFormat ()
void	setAlignment (Qt::Alignment alignment )
void	setFormat (const QString & format )
void	setInvertedAppearance (bool invert )
void	setTextDirection (QProgressBar::Direction textDirection )
void	setTextVisible (bool visible )
virtual QString	text () const
QProgressBar::Direction	textDirection () const
int	value () const

重实现公共函数

virtual QSize	minimumSizeHint () const override
virtual QSize	sizeHint () const override

公共槽

void	reset ()
void	setMaximum (int maximum )
void	setMinimum (int minimum )
void	setOrientation ( Qt::Orientation )
void	setRange (int minimum , int maximum )
void	setValue (int value )

信号

void	valueChanged (int value )

保护函数

void	initStyleOption (QStyleOptionProgressBar * option ) const

重实现保护函数

virtual bool	event (QEvent * e ) override
virtual void	paintEvent ( QPaintEvent * ) override

详细描述

进度条用于为用户给出操作进度指示，并安慰用户应用程序仍在运行。

The progress bar uses the concept of steps . You set it up by specifying the minimum and maximum possible step values, and it will display the percentage of steps that have been completed when you later give it the current step value. The percentage is calculated by dividing the progress ( value () - minimum ()) 除以 maximum () - minimum ().

可以指定最小和最大步进数采用 setMinimum () 和 setMaximum 。设置当前步进数采用 setValue ()。可以把进度条倒带到起始采用 reset ().

若把最小和最大两者设为 0，条展示繁忙指示器，而不是步进百分比。这很有用，例如，当使用 QNetworkAccessManager 下载项却无法确定要下载项的大小时。

另请参阅 QProgressDialog and GUI 设计手册：进度指示器 .

成员类型文档编制

enum QProgressBar:: Direction

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

常量	值	描述
QProgressBar::TopToBottom	0	文本被顺时针旋转 90 度。
QProgressBar::BottomToTop	1	文本被逆时针旋转 90 度。

注意：是否绘制文本取决于风格。目前 CleanLooks 和 Plastique 风格绘制文本。Mac、Windows 及 WindowsVista 风格不绘制文本。

该枚举在 Qt 4.1 引入或被修改。

另请参阅 textDirection .

特性文档编制

alignment : Qt::Alignment

此特性保持进度条的对齐

访问函数：

Qt::Alignment	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	invertedAppearance () const
void	setInvertedAppearance (bool invert )

另请参阅 orientation and layoutDirection .

maximum : int

此特性保持进度条的最大值

当设置此特性时， minimum 被调节，若有必要确保范围仍然有效。若当前值落在新范围之外，进度条被重置采用 reset ().

访问函数：

int	maximum () const
void	setMaximum (int maximum )

minimum : int

此特性保持进度条的最小值

当设置此特性时， maximum 被调节，若有必要确保范围仍然有效。若当前值落在新范围之外，进度条被重置采用 reset ().

访问函数：

int	minimum () const
void	setMinimum (int minimum )

orientation : Qt::Orientation

此特性保持进度条的方向

取向必须是 Qt::Horizontal (默认) 或 Qt::Vertical .

该特性在 Qt 4.1 引入。

访问函数：

Qt::Orientation	orientation () const
void	setOrientation ( Qt::Orientation )

另请参阅 invertedAppearance and textDirection .

text : const QString

此特性保持采用进度条展示的描述性文本

返回文本同进度条居中 (或某些风格左侧) 显示文本。

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

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

访问函数：

virtual QString

text () const

textDirection : Direction

此特性保持阅读方向为 text 为垂直进度条

此特性对水平进度条没有影响。默认情况下，读取方向为 QProgressBar::TopToBottom .

该特性在 Qt 4.1 引入。

访问函数：

QProgressBar::Direction	textDirection () const
void	setTextDirection (QProgressBar::Direction textDirection )

另请参阅 orientation and textVisible .

textVisible : bool

此特性保持是否应显示当前已完成的百分比

此特性可能被样式忽略 (如：QMacStyle 从不绘制文本)。

访问函数：

bool	isTextVisible () const
void	setTextVisible (bool visible )

另请参阅 textDirection .

value : int

此特性保持进度条的当前值

试图把当前值更改为最小-最大范围之外的某一值，不影响当前值。

访问函数：

int	值 () const
void	setValue (int value )

通知程序信号：

void	valueChanged (int value )

成员函数文档编制

QProgressBar:: QProgressBar ( QWidget * parent = nullptr)

构造进度条采用给定 parent .

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

另请参阅 setRange ().

[slot] void QProgressBar:: reset ()

重置进度条。进度条倒带且不展示进度。

[slot] void QProgressBar:: setRange ( int minimum , int maximum )

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

若 maximum 小于 minimum , minimum 变为唯一合法值。

若当前值落在新范围之外，进度条被重置采用 reset ().

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

另请参阅 minimum and maximum .

[signal] void QProgressBar:: valueChanged ( int value )

此信号被发射当进度条展示值改变时。 value 是由进度条展示的新值。

注意： 通知程序信号对于特性 value .

[virtual] QProgressBar:: ~QProgressBar ()

析构函数。

[override virtual protected] bool QProgressBar:: event ( QEvent * e )

重实现： QWidget::event (QEvent *event).

[protected] void QProgressBar:: initStyleOption ( QStyleOptionProgressBar * option ) const

初始化 option 采用值来自此 QProgressBar 。此方法对子类是有用的，当需要 QStyleOptionProgressBar ，但不希望自己填充所有信息。

另请参阅 QStyleOption::initFrom ().

[override virtual] QSize QProgressBar:: minimumSizeHint () const

重实现访问函数为特性： QWidget::minimumSizeHint .

[override virtual protected] void QProgressBar:: paintEvent ( QPaintEvent * )

重实现： QWidget::paintEvent (QPaintEvent *event).

[override virtual] QSize QProgressBar:: sizeHint () const

重实现访问函数为特性： QWidget::sizeHint .