编写可复用性更好的C 代码

编写可复用性更好的C 代码
——Band对象和COMToys(三)

编译/

原著:Paul Dilascia

MSJ &

关键字：Bands 对象，Desk Bands，Info/Comm Bands，Explorer Bar，Tool Bands。

本文假设你熟悉C ，COM，IE。

下载本文源代码: (128KB)
(75KB)


第一部分:Band 对象介绍
第二部分:BandObj的类层次和MyBands服务程序的注册


第三部分 深入Band内部，揭开Band的面纱

前面两个部分讨论了 MyBands 对象的创建和注册，现在MyBands已经注册妥当并且也具备了类工厂来创建它们，是揭穿Band对象真正面目的时候了。
Band对象是一个坐落在任务栏或IE中的窗口。但同时我还希望你认识到band对象也是一个必须实现如下三个接口的COM对象：IDeskBand, IObjectWithSite 和 IPersistStream。如果要接受用户输入，可选择实现IInputObject接口，如果下想要上下文菜单，可选择实现IContextMenu接口。图十展示了band对象的所有接口，包括必须实现的和可选择实现的接口。


图十

在Band对象的这些接口中，最重要的是IDeskBand接口，它派生于IDockingWindow,，而IDockingWindow又派生于IOleWindow。这两个接口是必须实现的接口。它们的作用是什么呢？
理解Band对象或任何诸如此类的COM对象的最好方法是检查对象存在时的一系列事件--如监测用户从工具栏中选择Band直到关闭Band期间的活动。为此最好的方法是用能运行的例子代码并在代码中加上TRACE诊断。BandObj具备有内建的诊断功能，它是通过使用一个我自己编写的诊断工具实现的，这个诊断工具叫TRACEFN。TRACEFN中用一个专门的类以及一个AfxTrace的自定制版本来产生期望的诊断输出，利用它可以看到堆栈的内容，图十一显示的就是MyBands运行时的诊断输出，从用户在工具栏菜单中选择Web搜索框开始一步一步往下走。
Windows（桌面band用于资源管理器，浏览栏用于IE）通过查找实现了CATID_DeskBand,，CATID_InfoBand，或 CATID_CommBand的COM对象来发现band对象，并将band的名字添加到工具栏菜单（如图四）。
当用户从菜单选中band时，Windows调用CoCreateInstance或它的同等函数。COM则调用DLL中的DllGetClassObject输出函数，而DllGetClassObject又调用AfxDllGetClassObject。MFC用正确的ID搜索到一个类工厂并将它返回。然后COM调用IClassFactory::CreateInstance进行一系列的COM常规处理。

接着，Windows查询IDeskBand 和IObjectWithSite接口。CBandObj以常用的MFC方式实现这些接口--使用嵌套类，接口映射，以及BEGIN/END_INTERFACE_PART，然后MFC返回正确的指针。
Windows调用IObjectWithSite::SetSite给出一个(IUnknown*)类型的指针指向对象容器。CBandObj::XObjectWithSite::GetSite调用CBandObj::OnSetSite虚函数，将嵌套类方法转换成父类的虚函数调用，以便你能轻松地重载。缺省的实现将现场m_spSite存储在中。你可以在m_spSite中查询（QueryInterface）任何容器实现的接口。CBandObj使用它获得其父窗口的HWND：

CComQIPtr spOleWin = m_spSite;

if (!spOleWin)

   return E_FAIL;

HWND hwndParent = NULL;

spOleWin->GetWindow(&hwndParent);

if (!hwndParent)

   return E_FAIL;      

当Windows调用SetSite时，它希望你创建自己的窗口。从有关说明文档中很难看出这一点来，我只是觉得很别扭。CBandObj::OnSetSite调用虚函数OnCreateWindow来做这个工作。我的缺省实现可以注册并创建通用的不可见窗口。

BOOL CBandObj::OnCreateWindow(CWnd* pParent, const CRect& rc)

{

   static BOOL bRegistered = FALSE;

   static CCriticalSection cs; // protection

   CTLockData lock(cs);

   // 注册窗口类

   if (!bRegistered) {

     AfxRegisterClass(...);

     bRegistered = TRUE;

   }

   return CWnd::Create(BANDOBJCLASS,...);

}     

Band对象的线程模型是"Apartment"，所以对全程变量的保护很重要。最好是尽可能让全程变量与使用它们的函数保持紧密联系。在例子中，OnCreateWindow是唯一使用bRegistered的函数，所以是一个静态函数。你可以重载OnCreateWindow来创建自己的窗口类，和/或者重载PreCreateWindow来改变窗口的某些属性。只是要记住：你创建的窗口一定要是不可见的，既保证不要使用WS_VISIBLE来创建窗口。
接下来，Windows调用IOleWindow::GetWindow来获得窗口的HWND。（这就是为什么你必须在SetSite中创建窗口的原因）。由CBandObj返回m_hWnd。
接着，Windows调用IDeskBand::GetBandInfo请求关于band的信息，如大小，可变高度或者定高，以及背景颜色和标题。CBandObj用默认值填充DESKBANDINFO结构--这些值都可以在band对象的构造函数中修改--有些信息来自你的资源文件。例如，从资源串中获得标题。下一步，Windows调用IDockingWindow:: ShowDW来显示创建的窗口。CBandObj 调用CWnd:: ShowWindow完成显示。
如果用户有输入或者用右键访问上下文菜单，则Windows要分别查询相应的IInputObject和IContextMenu接口。如果你实现了这些接口，Windows将使用它们。CBandObj的缺省实现从资源文件中获取键盘加速键和菜单信息。你只要将资源添加到工程就可以了。菜单本身被存在一个数据成员m_contextMenu中，可以随时取用。
CMyDeskBand没有资源菜单，取而代之的是通过读取用户属性设置文件来动态创建菜单（如图十二）。

图十二

在向容器添加菜单之前（当容器调用IContextMenu::QueryContextMenu时），CBandObj通过MFC的ON_UPDATE_COMMAND_UI命令处理器来路由菜单。如图十二，CMyDeskBand就是通过这种方式实现了搜索引擎旁边的选中检查标志。
如果用户使用菜单加速键或者选中菜单项来调用某个命令，Windows则会调用IContextMenu::InvokeCommand。CBandObj的做法与初始化这个菜单的做法一样，所以这个命令通常都会到达ON_COMMAND命令处理器。
当用户关闭Band时，Windows调用IDockingWindow::CloseDW。CBandObj则发送WM_CLOSE消息，这样窗口便消失。但是CBandObj对象仍然活着，直到Windows释放它。只要你用TRACE跟踪一下就会明白以上所述的逻辑过程了。（待续）