QProgressBar 类

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

头: #include <QProgressBar>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
继承: QWidget

公共类型

enum Direction { TopToBottom, BottomToTop }

特性

公共函数

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 )

保护函数

virtual 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 .

成员类型文档编制

enum QProgressBar:: Direction

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

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

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

另请参阅 textDirection .

特性文档编制

alignment : Qt::Alignment

此特性保持进度条的对齐

访问函数:

Qt::Alignment alignment () const
void setAlignment (Qt::Alignment alignment )

format : QString

此特性保持用于生成当前文本的字符串

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

默认值为 "%p%"。

访问函数:

QString format () const
void setFormat (const QString & format )
void resetFormat ()

另请参阅 text ().

invertedAppearance : bool

此特性保持进度条是否展示其进度的反转

若此特性为 true ,进度条朝另一方向 (如:从右到左) 增长。默认情况下,进度条不反转。

访问函数:

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::Orientation orientation () const
void setOrientation (Qt::Orientation)

另请参阅 invertedAppearance and textDirection .

[read-only] text : const QString

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

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

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

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

访问函数:

virtual QString text () const

textDirection : Direction

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

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

访问函数:

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 value () const
void setValue (int value )

通知程序信号:

void valueChanged (int value )

成员函数文档编制

[explicit] QProgressBar:: QProgressBar ( QWidget * parent = nullptr)

构造进度条采用给定 parent .

默认情况下,最小步幅值被设为 0,而最大为 100。

另请参阅 setRange ().

[虚拟] QProgressBar:: ~QProgressBar ()

析构函数。

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

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

[virtual 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).

[slot] void QProgressBar:: reset ()

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

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

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

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

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

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

另请参阅 minimum and maximum .

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

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

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

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

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