CProgressCtrl

“ 进度条控件 ” 是一个窗口，应用程序可以使用这个窗口来表明一个冗长操作

的进度。它由一个从左到右，用系统高亮色逐渐填充的矩形组成。

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

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

#include <afxcmn.h>

CProgressCtrl 类成员

Construction

CprogressCtrl 构造一个 CProgressCtrl 对象

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

Attributes

SetRange 为进度条控件设置范围的最小值和最大值，并重画进度条来反映新的范围

SetRange32 为进度条控件设置范围的最小值和最大值，并重画

进度条来反映新的范围

GetRange 获取进度条控件范围的下限和上限

GetPos 获取进度条的当前位置

SetPos 设置进度条的当前位置并重画进度条来反映新的位置

OffsetPos 用一个指定的增量来增加进度条控件的当前位置，

并重画此进度条来反映新的位置

SetStep 为一个进度条控件指定每一步的增量

Operations

StepIt 用每一步的增量（参见 SetStep ）来增加一个进度条控件的当前位置，并重画此进度条来反映新的位置

成员函数

CProgressCtrl::CProgressCtrl

CProgressCtrl();

说明

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

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

请参阅 CProgressCtrl::Create

CProgressCtrl::Create

BOOL Create( DWORD dwStyle , const RECT& rect , CWnd* pParentWnd , UINT

nID );

返回值

如果 CProgressCtrl 对象被成功创建则返回 TRUE ；否则返回 FALSE 。

参数

dwStyle

指定进度条控件的风格。除了 Windows 风格的任何组合，附加下列进度条控件风格：

PBS_VERTICAL 垂直显示进度信息，从顶到底。没有这个
标志，进

度条控件从左到右水平显示。

PBS_SMOOTH 逐渐显示，平滑地填充进度条控件。没有这
个标志，控件将用块来填充。

rect

指定进度条控件的尺寸和位置。它可以是一个 CRect 对象或者是一个RECT 结构。由于此控件必须是一个子窗口，所以指定的坐标是相对于pParentWnd 的客户区的。

pParentWind

指定进度条控件的父窗口，通常是一个 CDialog。它不能是 NULL 。

nID

指定进度条控件的 ID 。

说明

你可以分两步来构造一个 CProgressCtrl 对象。首先调用构造函数来创建

CProgressCtrl 对象；然后调用 Create 来创建进度条控件。

请参阅 CProgressCtrl:: CProgressCtrl

CProgressCtrl::GetPos

int GetPos();

返回值

返回进度条控件的位置。

说明

此成员函数用来检取进度条的当前位置。进度条的这个位置不是它在屏幕上的

请参阅 CProgressCtrl::SetPos

CProgressCtrl::GetRange

void GetRange( int & nLower , int& nUpper );

参数

nLower

个指向整数的引用，它用来接收进度条控件的下限。

nUpper

个指向整数的引用，它用来接收进度条控件的上限。

说明

此成员函数用来获取当前进度条控件的上限和下限，或者说是范围。此函数将

请参阅 PBRANGE ， PBM_GETRANGE

CProgressCtrl::OffsetPos

int OffsetPos( int nPos );

返回值

返回进度条控件的早先的位置。

参数

nPos

用来增加位置的数量。

说明

此函数用由 nPos 指定的增量来增加进度条控件的当前位置，并且重画此进度条来反映新的位置。

请参阅 CProgressCtrl::SetPos， CProgressCtrl::SetRange ， CProgressCtrl::StepIt

CProgressCtrl::SetPos

int SetPos( int nPos );

返回值

返回进度条控件的早先的位置。

参数

nPos

进度条控件的新位置。

说明

此成员函数根据 nPos 指定的位置来设置进度条控件的当前位置，并重画此进度条来反映新的位置。

进度条的这个位置不是它在屏幕上的物理位置，而是在 SetRange 中的上限和下限范围之间的位置。

请参阅 CProgressCtrl::OffsetPo s，CProgressCtrl::SetRange ，CProgressCtrl::StepIt

CProgressCtrl::SetRange

void SetRange( short nLower , short nUpper ); void SetRange32(int nLowe r , int nUpper );

参数

nLower

指定范围的下限（缺省值是零）。

nUpper

指定范围的上限（缺省值是 100 ）。

说明

此函数用来设置进度条控件范围的上限和下限，并重画此进度条来反映新的范围。

成员函数 SetRange32 为进度条设置 32 位的范围。

请参阅 CProgressCtrl::OffsetPo s， CProgressCtrl::SetPo s， CProgressCtrl::StepIt

CProgressCtrl::SetStep

int SetStep( int nStep );

返回值

返回原来的步增量。

参数

nStep

新的步增量。

说明

此函数为进度条控件指定步增量。步增量就是每调用一次 CProgressCtrl::StepIt

所增加进度条控件的当前位置的数量。

缺省的步增量是 10 。

请参阅 CProgressCtrl::OffsetPo s， CProgressCtrl::SetPo s， CProgressCtrl::StepIt

CProgressCtrl::StepIt

int StepIt();

返回值

返回进度条控件的原来的位置。

说明

此函数用步增量来增加一个进度条控件的当前位置。该步增量由成员函数

CProgressCtrl::SetStep 来设定。

请参阅 CProgressCtrl::SetPos， CProgressCtrl::SetRange ， CProgressCtrl::SetStep

CProgressCtrl

CProgressCtrl

CProgressCtrl 类 成 员

成 员 函 数

CProgressCtrl 类成员

成员函数