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 }