CProgressCtrl

词条简介

（1）派生关系：

CObject

  

└CCmdTarget

└CWnd

└CProgressCtrl

（2）简介

“进度条控件”是一个窗口，应用程序可以使用这个窗口来表明一个冗长操作的进度。它由一个从左到右，用系统高亮色逐渐填充的矩形组成。

CProgressCtrl类提供了Windows通用进度条控件的机能。这个控件（也就是CProgressCtrl类）只有对运行在Windows 95和Windows NT 3.51或更高版本下的程序才是有效的。

进度条控件具有一个范围和一个当前位置。范围代表了操作的整个期间，当前位置代表了应用程序为完成操作已经做完的部分。窗口进程用范围和当前位置来确定用高亮色填充进度条的百分比，以及确定在进度条中所显示的文本（如果有的话）。由于范围和当前位置值是用有符号整数表示的，所以可能的当前位置值的范围是从-214783648到214783647 (-2^16 ~ + 2^16)。

类成员

（1）构造函数

CProgressCtrl() 构造一个CProgressCtrl对象

Create() 创建一个进度条控件并将它与一个CProgressCtrl对象连接

（2）属性

void SetRange( short nLower, short nUpper );为进度条控件设置范围的最小值和最大值，并重画进度条来反映新的范围,默认为0~100，若设置32位范围，用下面的函数。

void SetRange32( int  nLower , int  nUpper ); 为进度条控件设置范围的最小值和最大值，并重画进度条来反映新的范围

void GetRange( int&  nLower , int&  nUpper ); 获取进度条控件范围的下限和上限

int GetPos(); 获取进度条的当前位置

int SetPos(int nPos); 设置进度条的当前位置并重画进度条来反映新的位置

int OffsetPos(int nPos); 用一个指定的增量来增加进度条控件的当前位置，并重画此进度条来反映新的位置

int SetStep( int nStep );为一个进度条控件指定每一步的增量。

（3）操作

int StepIt();提出一个进度条控件的每一步增量的当前位置(见SetStep)并重绘进度条以反映新的位置变化

构造函数

CProgressCtrl::CProgressCtrl

CProgressCtrl();

说明：

此成员函数用来构造一个CProgressCtrl对象。

在构造一个CProgressCtrl对象后，调用CProgressCtrl::Create来创建进度条控件。

请参阅：CProgressCtrl::Create