文档库 最新最全的文档下载
当前位置:文档库 › QProgressBar

QProgressBar

QProgressBar
QProgressBar

QProgressDialog类

#include

QProgressBar小部件提供了一个水平或垂直的进度条。继承自QWidget类。

1、详细描述

一个进度条是用来给用户的操作的进度指示,并再保证他们的应用程序仍在运行。

QProgressBar类提供了一种横向或者纵向的显示进度的空间表示方式,用来描述任务的完成情况。

进度条使用了一个步进值的概念,即一旦设置好了进度条的最大值和最小值,进度条将会显示完成的步进值占总的步进值的百分比,百分比的计算公式为:

百分比=(value() - minimum()) /( maximum() - minimum()).

你可以使用setMinimum() and setMaximum()来设置步进最大值和步进最小值。使用setValue()来设置当前的步进值。进度条可以使用reset()回到进度开始的地方。

如果最小和最大两个都设置为0,指示条显示了一个繁忙的指示,而不是步进的百分比。这是有用的,例如,使用QFtp或QNetworkAccessManager何时下载项目时,他们无法确定的情况下载项目的大小。

enum QProgressBar::Direction

指定文本为垂直进度条的步进方向。

注意,文字是否绘制取决于风格。目前CDE,CleanLooks,Motif和PLASTIQUE绘制文本风格。Mac,Windows和WindowsXP的风格没有。

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 )

invertedAppearance : bool

这个属性保存的进度条是否显示进度反相。

如果此属性为false时,进度条在其他方向生长(例如从右到左)。默认情况下,进度条不倒。相关函数:bool invertedAppearance ()

bool invertedAppearance () const

void setInvertedAppearance ( bool invert )

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::V ertical.

相关函数:Qt::Orientation orientation () const

void setOrientation ( Qt::Orientation )

text : const QString

这个属性保存的进度条显示的说明文字。

text 返回的是进度条在中心显示的文本(或在某些样式中是在左侧)。

在文本显示的进度可能比最低值越小,表明该进度条是在“复位”状态取得进展之前设置。迄今取得的进展中,在默认实现文本是载一个百分比值,或者是空白的,因为进度条此时处于复位状态。

相关函数:virtual QString text () const

textDirect : Direction

这个属性保存的文本垂直进度条的阅读方向。

此属性对水平进度条没有影响。默认情况下,阅读方向是QProgressBar:: TopToBottom中。相关函数:QProgressBar::Direction textDirection ()

QProgressBar::Direction textDirection () const

void setTextDirection ( QProgressBar::Direction textDirection )

textVisible : bool

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

相关函数:bool isTextVisible () const

void setTextVisible ( bool visible )

value : int

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

相关函数:int value () const

void setValue ( int value )

3、成员函数文档

QProgressBar::QProgressBar ( QWidget * parent = 0 )

构造一个给定的父窗口的进度条。

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

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

这个虚函数接收事件的对象,如果事件e识别并处理则返回true。

event()函数以自定义对象的行为重新实现。

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

从这个QProgressBar的值初始化选项。当他们需要一个QStyleOptionProgressBar或QStyleOptionProgressBarV2此方法对于子类有用的,但不希望所有的信息填写自己。此函数将检查QStyleOptionProgressBar的版本,并填写了QStyleOptionProgressBarV2的附加值。QSize QProgressBar::minimumSizeHint () const [virtual]

这个属性保存的是进度条建议的最小大小。

如果这个属性的值是一个无效的大小,则没有最小大小推荐。

如果没有布局这个进度条,则默认实现的函数minimumSizeHint() 返回一个无效的大小,否则返回布局的最小尺寸。大多数内置的部件重新实现minimumSizeHint()。

void QProgressBar::reset () [slot]

重置进度条。

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

用minimum和maximum分别设置进度条的最小值和最大值。如果最大值比最小值小,最小成为唯一的合法值。如果当前值超出了新的范围,进度条将使用reset()复位。

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

当进度条改变显示的值这个信号被发射。值是通过进度条显示的新值。

QSize QProgressBar::sizeHint () const [virtual]

这个属性保存窗口的推荐的大小。如果这个属性的值是一个无效的大小,没有大小推荐。如果有这个进度条没有布局,sizeHint的默认实现()返回一个无效的大小,否则返回布局的首选大小。

举例:

int mun=ui->wenjian_lineEdit->text().toInt();//从lineEdit控件框内取得值作为要进行处理的文件数

ui->progressBar->setRange(0,mun);//设置进度条的进度范围

for(int i=1;i

{

ui->progressBar->setValue(i);//设置当前的进度值

/*此处添加文件复制过程*/

Sleep(1);//让程序停顿一下,使用的头文件是#include

}

相关文档