（转）VC技巧：在程序的状态栏中实现进度条

VC技巧：在程序的状态栏中实现进度条

---

2008-04-29 19:21:56

　标签：VC 实现 进度条　　　[推送到技术圈]

这两天在做一个RSA的加密解密工具，顺便也学习下传说中的MFC。
本文转载于：http://news.newhua.com/html/VC/2006-3/30/063301515277326_46.shtml

　　读者朋友们可能天天使 用Visual C++这个强大的工具来开发应用程序，不知道注意到没有，Visual C++每次装载一个项目的时候，为了使项目加载过程不至于太单调，会在状态栏的左半部分会出现一个装载进度条，用来即时显示Visual C++装载项目的进度，当项目装载完毕后，进度条隐藏。那么这个功能是如何实现的呢？为了说明该功能的实现原理，本例提供了一个范例程序prgsbar， 它演示了在编辑视图里显示文本文件，在加载文本文件时，在界面的状态条中的进度指示器仿真显示文件的加载过程，当文本装载完毕后，进度条隐藏。由于该程序 在装载文件显示的进度条时无法进行拷屏操作，所以这里没有给出状态条中显示进度条的界面效果图，读者可以运行本书所带光盘中的程序代码观看相应的效果。

一、实现方法

虽然Visual C++中的MFC类提供了标准的进度指示器控件（progress control），但是我们不能在状态栏里直接使用这个控件，要解决这个问题，可以创建一个可重用C++类CProgStatusBar，这个类从 CStatusBar派生，用来来实现状态条中的进度指示。整个实现过程不是很难，思路是在状态栏创建一个进度指示器控制，把它作为子窗口来对待，然后根 据不同的状态来显示或者隐藏进度指示器。

在具体实现CProgStatusBar类的过程中，首先在CProgStatusBar派 生类中加了一个CProgressCtrl类型的数据成员--m_wndProgBar，然后重载CstatusBar类的二个重要成员函数： OnCreate（）、OnSize（），最后还要在该类中添加一个自定义成员函数OnProgress（）。在上述三个函数中， OnCreate（）负责在状态栏第一次被创建时接收控制，继而创建进度指示器并将它初始化为一个子窗口，它的实现代码如下：

int CProgStatusBar::OnCreate(LPCREATESTRUCT lpcs)
{
lpcs->style |= WS_CLIPCHILDREN;
VERIFY(CStatusBar::OnCreate(lpcs)==0);
VERIFY(m_wndProgBar.Create(WS_CHILD, CRect(), this, 1));
m_wndProgBar.SetRange(0,100);
return 0;
}

OnCreate（）函数在状态栏的式样中加了一个WS_CLIPCHILDREN，它告诉Windows不要绘制子窗口以下的状态栏区域，这样可以减 少屏幕闪烁。接着OnCreate（）函数创建进度指示器控件并将它的范围设置成[0，100]。注意在这里创建进度指示器控件时没有用 WS_VISIBLE，因为我们要实现的目标是仅仅当装载文件时进度条才显现，其余时间内应用程序都隐藏它。

熟悉Windows编程 的人都清楚，无论何时，只要在某个窗口里添加子窗口，那么一定要负责管理它的大小尺寸，也就是说，当父窗口大小改变后，子窗口的大小也要跟着作相应的改 变。一般来说，这个工作由父窗口的WM_SIZE消息处理函数OnSize（）来作，所以我们也要处理该类的OnSize（）函数。

void CProgStatusBar::OnSize(...)
{
CStatusBar::OnSize(...);
CRect rc;
GetItemRect(0, &rc);//获取状态条的第一个窗口的尺寸；
m_wndProgBar.MoveWindow(&rc,FALSE);//移动进度条到状态条的第一个窗口；
}

从上述代码可以看出，CProgStatusBar::OnSize（）将进度指示器放在了状态栏的第一个窗格，这个窗格通常用来显示程序的"就绪"信 息和命令提示信息。注意这里不论进度指示器是处于可见状态还是隐藏状态，MoveWindow都照样起作用--所以即便是进度指示器处于隐藏状态，其窗口 大小同样是可调的。

调整好进度指示器的窗口大小后，下面要作的就是进度指示器的显示，进度指示器当前进度状态的显示在 CProgStatusBar::OnProgress中完成。它有一个类型为UINT的入口参数：参数值的范围从0到100，表示进度百分比，0表示进 度没开始，100表示全部完成。如果这个参数的值大于0，则OnProgress显示进度控制并设置指示器的位置；如果参数值等于0，则 OnProgress隐藏进度控制。

　　虽然子窗口控件通常都 是放在父窗口能绘制的区域的最上面，但这样做在绘制方面是有一定风险的。在隐藏/显示进度控制时尤其如此，这时候会出现两个问题：第一，因为进度指示器显 示在状态栏的第一个窗格位置，所以如果进度条指示器显示时已经显示有状态信息，那么进度指示器和状态信息文本就会有冲突，相互干扰。之所以会这样，是因为 进度控制假设其绘制背景是干净的，并且只绘制进度控制的着色部分。解决这个问题最简单的方法是调用CStatusBar::SetWindowText (NULL)函数在显示进度指示器之前打扫一下环境卫生，清除以前的文本。

对于状态栏来说，SetWindowText函数的作用是 设置状态栏第一个窗格的文本。反之，当调用OnProgress(0)清除进度控制时也存在类似的问题，CProgStatusBar:: OnProgress 隐藏进度控制后，状态栏第一个窗格该显示什么信息呢？一般显示"就绪"或其它的提示信息。当应用程序不做任何事情时，MFC程序总是在这个位置显示资源串 AFX_IDS_IDLEMESSAGE表示的文本，其缺省值为"就绪"，当然读者朋友们可以在当前项目的RC文件中任意修改这个值，不管怎样，在MFC 程序的状态栏中显示"就绪"信息很容易，需要作的就是在CProgStatusBar::OnProgress（）函数中调用语句GetParent() ->PostMessage(WM_SETMESSAGESTRING,AFX_IDS_IDLEMESSAGE)向父窗口发送一个 WM_SETMESSAGESTRING消息就可以了，需要注意的是，使用消息WM_SETMESSAGESTRING时必须包含它的定义文件 "afxpriv.h"，否则程序会报告编译错误。

上述CprogStatusBar类实现了状态栏中包含进度条控件，该类的使用方 法很简单，首先在应用程序的CmainFrame类中用CProgStatusBar代替CStatusBar声明实例，然后在任何想要显示进度控制指示 的地方调用CProgStatusBar::OnProgress。本例中定义了一个消息MYWM_PROGRESS，它将进度条当前的进度作为 WPARAM参数传递到CProgStatusBar::OnProgress（）函数。

经过上述处理，想要使用进度指示的任何对象 都可以通过发送一个消息到主框架来调用状态栏进行进度条的显示。例如，在例子程序中，文档的Serialize（）函数在加载文本文件时，利用Sleep （）函数仿真耗时加载，每隔150毫秒报告一次进度状态。如果你不想从文档发送Windows消息，可以用MFC的视图更新机制来做。你可以发明一个"暗 示"代码以及一个小结构来保存进度百分比数据，并通过向框架发送MYWM_PROGRESS消息调用暗示信息。这是从文档到视图/框架传递进度控制信息的 最省事的方式。

　　二、编程步骤

1、 启动Visual C++6.0，生成一个单文档应用程序prgsbar，项目的视图类的基类选择CEdit类；

2、 在程序的Resource.h文件中添加自定义消息的定义：

#define MYWM_PROGRESS (WM_USER+1)

3、 在程序的主框架窗口CMainFrame类的头文件中声明MYWM_PROGRESS的消息响应函数afx_msg LRESULT OnProgress(WPARAM wp, LPARAM lp)，在该类的实现中添加消息映射ON_MESSAGE(MYWM_PROGRESS,OnProgress)；

4、 将CMainFrame类中的工具条对象改为CProgStatusBar m_wndStatusBar；

5、 重载CPrgsbarDoc::Serialize(CArchive& ar)函数，用来处理读取文件时的进度条仿真；

6、 添加代码，编译运行程序。

三、程序代码

////////////////////////////////////////////CprogStatusBar类的头文件；
// Status bar with progress control.
class CProgStatusBar : public CStatusBar {
public:
CProgStatusBar();
virtual ~CProgStatusBar();
CProgressCtrl& GetProgressCtrl() {
return m_wndProgBar;
}
void OnProgress(UINT pct);
protected:
CProgressCtrl m_wndProgBar; // the progress bar
afx_msg int OnCreate(LPCREATESTRUCT lpCreateStruct);
afx_msg void OnSize(UINT nType, int cx, int cy);
DECLARE_MESSAGE_MAP()
DECLARE_DYNAMIC(CProgStatusBar)
};
///////////////////////////////////////////////////////////////////////////// CprogStatusBar类的实现文件；
#include "StdAfx.h"
#include "ProgBar.h"
#ifdef _DEBUG
#define new DEBUG_NEW
#undef THIS_FILE
static char THIS_FILE[] = __FILE__;
#endif
IMPLEMENT_DYNAMIC(CProgStatusBar, CStatusBar)
BEGIN_MESSAGE_MAP(CProgStatusBar, CStatusBar)
ON_WM_CREATE()
ON_WM_SIZE()
END_MESSAGE_MAP()
////////////////////////////////////////////////////////////////
CProgStatusBar::CProgStatusBar()
{}
CProgStatusBar::~CProgStatusBar()
{}
////////////////////////////////////////创建状态条时也创建进程条
int CProgStatusBar::OnCreate(LPCREATESTRUCT lpcs)
{
lpcs->style |= WS_CLIPCHILDREN;
VERIFY(CStatusBar::OnCreate(lpcs)==0);
VERIFY(m_wndProgBar.Create(WS_CHILD, CRect(), this, 1));
m_wndProgBar.SetRange(0,100); //设置进程条的范围；
return 0;
}
////////////////////////////////////////////////////使进程度条的尺寸与状态条的尺寸同步变化；
void CProgStatusBar::OnSize(UINT nType, int cx, int cy)
{
CStatusBar::OnSize(nType, cx, cy);
CRect rc;
GetItemRect(0, &rc);
m_wndProgBar.MoveWindow(&rc,FALSE);
}
////////////////////////////////////////////////////////////根据pct的当前值对进程条进行设置
void CProgStatusBar::OnProgress(UINT pct)
{
CProgressCtrl& pc = m_wndProgBar;
DWORD dwOldStyle = pc.GetStyle();
DWORD dwNewStyle = dwOldStyle;
if (pct>0) //如果pct>0，将显示进度条
dwNewStyle |= WS_VISIBLE;
else //否则隐藏进度条；
dwNewStyle &= ~WS_VISIBLE;
if (dwNewStyle != dwOldStyle) {
SetWindowText(NULL); //显示进度条前清空状态条；
SetWindowLong(pc.m_hWnd, GWL_STYLE, dwNewStyle);
//设置进度条处于显示状态；
}
// 设置进度条的当前位置；
pc.SetPos(pct);
if (pct==0)
// 如果pct等于0，通知主框架窗口显示空闲信息；
GetParent()->PostMessage(WM_SETMESSAGESTRING, AFX_IDS_IDLEMESSAGE);
}
/////////////////////////////////////////////////////////////////////////文档装载处理函数；
void CPrgsbarDoc::Serialize(CArchive& ar)
{
CWnd* pFrame = AfxGetMainWnd();
if (!ar.IsStoring()) {
for (int pct=10; pct<=100; pct+=10) {//对文档装载进行仿真处理；
Sleep(150);
if (pFrame)
pFrame->SendMessage(MYWM_PROGRESS, pct);
}
}
if (pFrame)
pFrame->SendMessage(MYWM_PROGRESS, 0);
((CEditView*)m_viewList.GetHead())->SerializeRaw(ar);//显示文本文件的内容；
}

四、小结

本例虽然是介绍的如何在状态条中包含进度条，但是读者朋友们可以从中受到启发，开拓思路，将该思想应用到类似的应用当中去，例如在状态条中实现显示图像等。