现在的位置: 首页 > 综合 > 正文

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

2013年05月10日 ⁄ 综合 ⁄ 共 3256字 ⁄ 字号 评论关闭

编译/赵湘宁

原著:Paul Dilascia

MSJ November 1999 & December 1999

关键字:Bands 对象,Desk Bands,Info/Comm Bands,Explorer Bar,Tool Bands。

本文假设你熟悉C++,COM,IE。

下载本文源代码: MyBands.zip (128KB)
                TestEditSrch.zip (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跟踪一下就会明白以上所述的逻辑过程了。(待续)

抱歉!评论已关闭.