视频1 视频21 视频41 视频61 视频文章1 视频文章21 视频文章41 视频文章61 推荐1 推荐3 推荐5 推荐7 推荐9 推荐11 推荐13 推荐15 推荐17 推荐19 推荐21 推荐23 推荐25 推荐27 推荐29 推荐31 推荐33 推荐35 推荐37 推荐39 推荐41 推荐43 推荐45 推荐47 推荐49 关键词1 关键词101 关键词201 关键词301 关键词401 关键词501 关键词601 关键词701 关键词801 关键词901 关键词1001 关键词1101 关键词1201 关键词1301 关键词1401 关键词1501 关键词1601 关键词1701 关键词1801 关键词1901 视频扩展1 视频扩展6 视频扩展11 视频扩展16 文章1 文章201 文章401 文章601 文章801 文章1001 资讯1 资讯501 资讯1001 资讯1501 标签1 标签501 标签1001 关键词1 关键词501 关键词1001 关键词1501 专题2001
ATL和MFC来创建ActiveX控件
2025-09-26 11:04:40 责编:小OO
文档
用ATL和MFC来创建ActiveX控件

摘要目前MFC和ATL代表了两种框架,分别面向不同类型的基于Windows的开发。MFC代表了创建的Windows应用的一种简单、一致的方法;ATL提供了一种框架来实现创建COM客户机和服务器所必须的样板文件代码。这两种框架在它们对于开发ActiveX的用途上会合了。我们将看看这两种框架是如何适用于创建ActiveX控件的——突出其优缺点,亲自经历创建一个控件的过程——以便你能够决定何时使用一种框架,何时使用另一种。

  如果你希望用C++来写ActiveX®控件,有两个流行的框架,一个是Microsoft® Foundation Classes (MFC),另一个是ATL。我将深入的解释这两种框架对开发ActiveX控件所提供的支持,帮助你更好的决定哪种模型最适合你的开发环境和需求。

  ActiveX控件的完全形态

  ActiveX控件基于构件对象模型COM,使得ActiveX控件成为可能的COM的基本原则是一个对象的接口和其实现能够而且应该分开对待。只要COM的对象和它的客户方代码就接口细节达成了一致,如何实现就不成其问题。ActiveX控件展示了大量ActiveX控件包容器理解的接口。因为客户方代码和控件认可这些接口的外在表现,你可以编写一个ActiveX控件然后简单的将它放入包容器中。包容器将通过良好定义的接口来驱动控件,而这些控件将以自己的方式做出合适的响应。在更高的层次上,一个ActiveX控件是实现了几个主要ActiveX技术的一个COM对象,包括通常的引入COM接口,OLE嵌入协议,连接点和属性页。在较低的编程层次上,ActiveX控件只是实现了某些类型接口的COM类。当一些客户方代码成功的查询到这些接口之一时,它就知道如何使用一个ActiveX控件了。

一个ActiveX控件暴露的接口主要分为3类。第一,ActiveX控件是可嵌入的对象;就是说,它们实现了大多数的OLE文档、in-place激活和嵌入协议。ActiveX控件实现了如下的接口:

IOleObject, IPersistStorage, IDataObject, IOleInPlaceActiveObject, IOleInPlaceObject, IViewObject2和IRunnableObject (这一个很少用到). 第二ActiveX控件通常都支持属性页,这样客户方就可以修改控件的属性了。最后,ActiveX控件通常都利用COM的连接点技术,实现了客户方能发现的外出接口。

为了帮助比较ATL和MFC框架,我们来看一下写在每一种框架中的相同的控件。此控件监视创建它的线程上传递的消息流。消息流控件是一个很不错的例子,因为它演示了一个ActiveX控件所有主要的方面,包括送入接口、外出接口,属性,永久性以及属性页。让我们从研究这两个框架提供的标准的COM支持开始吧。

  MFC的基本COM支持

Microsoft建立MFC使得开发Windows®应用程序比使用SDK容易多了。有了MFC,Microsoft接着增加了对即存框架的COM支持。这意味着MFC的开发者在增加越来越多的函数时必须保持框架的完整。同时,Visual C++®编译器那时还不支持模板,因此,它们不得不借助非模板的其它手段来将COM功能掺入它们的类中。Microsoft通过加入一些虚函数到CcmdTarget类和一些宏中解决了这个问题,使得在MFC中实现COM接口有了可能。

MFC内部的COM支持从CcmdTarget开始,CcmdTarget类实现了Iunknown接口,还包括了一个用于引用计数的成员变量(m_dwRef)以及用于实现IUnknown 的6个函数:: InternalAddRef, InternalRelease, InternalQueryInterface, ExternalAddRef, ExternalRelease, 和 ExternalQueryInterface.。QueryInterface的两个版本——AddRef和Release支持COM聚合。InternalAddRef, InternalRelease和InternalQueryInterface完成引用计数和QueryInterface操作,而ExternalAddRef, ExternalRelease和 ExternalQueryInterface代理控制聚合的对象(如果此对象参与聚合的话)。

MFC使用嵌套的类复合策略来实现COM接口。在MFC中,想实现COM 接口的类是从CcmdTarget中派生的。每个由CcmdTarget派生出的类实现的接口得到它自己的嵌套类。MFC使用宏BEGIN_INTERFACE_PART和END_INTERFACE_PART来产生嵌套类。

最后,MFC实现了表驱动的QueryInterface。MFC的接口映射的工作机理同它的消息映射基本相同:MFC的消息映射把一个Windows消息和一个C++类中的函数相联系;MFC的接口映射把一个接口的GUID和一个表示此接口的特定的vptr的地址相联系。每个基于CcmdTarget的类实现COM接口通过更多的宏:DECLARE_INTERFACE_MAP, BEGIN_INTERFACE_MAP, INTERFACE_PART,和 END_INTERFACE_MAP来增加一个接口映射。

为了理解这些宏在实际中是什么样子的,请看图1,它说明了实现ActiveX控件,COleControl 的MFC类。当你细读代码时,注意ColeControl带有夹在一对BEGIN_INTERFACE_PART 和 END_INTERFACE_PART宏之间的每个接口的签名,还要注意ColeControl的接口映射表有22个条目。

除了实现了Iunknown接口,MFC还包括IclassFactory的一个标准实现。再一次,MFC通过若干宏提供了此支持。MFC有两个宏来提供类对象:DECLARE_OLECREATE_EX 和 IMPLEMENT_OLECREATE_EX.。在一个基于CcmdTarget的类中使用这些宏增加一个ColeObjectFactory类型的静态成员到该类中。如果你看一下AFXDISP.H中 ColeObjectFactory的定义,你将会看到用在COleObjectFactory 中的MFC的嵌套类宏为实现IClassFactory2定义了一个嵌套类。IClassFactory::CreateInstance的MFC版本使用MFC的动态创建机制(DECLARE_DYNCREATE 和 IMPLEMENT_DYNCREATE宏打开此功能)来实例化COM类,因此买入MFC的COM支持同样意味着买入它的动态创建机制。

最后几个由MFC提供的在ActiveX控件内的基本COM支持是对Idispatch的支持。用Visual C++ 和 MFC实现一个分发接口几乎是微不足道的。在MFC中实现一个分发接口,只需要使用ClassWizard就可以了。ClassWizard中的自动创建板有一个按钮用于添加属性,另一个用于添加方法。在MFC中,Idispatch支持来自CcmdTarget类。IDispatch 的MFC的实际实现在一个叫做COleDispatchImpl 的类中,ColeDispatchImpl派生自Idispatch,实现了所有4个Idispatch函数:GetTypeInfoCount, GetTypeInfo, GetIDsOfNames, 和 Invoke.。由CcmdTarget派生的类通过调用EnableAutomation,将IDispatch vptr加入到它们的接口映射中。当客户在基于MFC的ActiveX控件上调用IDispatch 的QueryInterface时,CcmdTarget交出链接在ColeDispatchImpl上的vptr。

每次你使用ClassWizard将一个自动属性或者方法加入到一个类中时,你同时也在该类的分发映射表中加入了一项。一个分发映射表是一个将DISPIDs(用来调用分发成员的符号)和它们的供人读的名字以及和实际完成这个工作的某些C++代码联系起来的简单的表格。ColeDispatchImpl的调用以及GetIDsOfNames函数通过在类的分发映射表中查找分发成员并分发DISPID相对应的函数来工作。MFC能为某些基于COM的高级技术如OLE文档、OLE拖放和自动操作提供非常好的支持,然而,如果你想更改框架——比如说,你想将分发接口编程双接口的——你就得大动手脚了。另一方面,ATL更加是COM中心的。

  ATL的基本的COM支持

ATL的目标是使开发者不必重写IUnknown, IDispatch, IclassFactory和其它的分支以将常规的DLL和EXE变成基于COM的DLL和EXE。从这个角度讲,ATL是一个比MFC精简的多的框架,它设计和生成时就考虑了COM支持。它使用基于模板的方法,通过继承ATL提供的模板,开发者可以加入各种COM功能片断。

ATL的原始COM支持是从对Iunknown的支持开始的。ATL的Iunknown实现分成两个部分:CcomObjectRootEx类,用来处理Iunknown部分的引用计数;CcomObjectRootBase类,用来处理QueryInterface。

CcomObjectRootEx是一个基于模板的类,将线性模型作为其唯一参数。这是一个真正有趣的说明ATL怎样使用模板将算法作为模板参数传递的例子。ATL有两个处理引用计数的类,用于处理不同的线性模型: CComSingleThreadModel 和 CcomMultiThreadModel。这些类每个都有一个递增和一个递减函数。它们之间的区别是CcomSingleThreadModel用标准C++操作符(++和——)实现递增和递减;而CcomMultiThreadModel使用线程安全的InterlockedIncrement 和 InterlockedDecrement函数来实现这两个功能。根据用来实例化CcomObjectRootEx的模板参数,它能正确的运行给定的组件类型。你很快将会看到它的用法的一个例子。象MFC,ATL使用基于表的查找机制实现QueryInterface.。CComObjectRootBase 通过一个接口映射处理类的QueryInterface函数。BEGIN_ COM_MAP 和 END_COM_MAP 宏定义了一个接口映射的开始和结束。然而,不像MFC,ATL提供了17种途径来组成一个接口映射,例如使用从ATL的基于模板的接口实现类如IOleObjectImpl 来的vptrs。这包括了那些从tear-off 的类或者由聚合提供的类来的vptrs。

在ATL里,C++类通过继承CcomObjectRootEx,指定它们想用的组件模型(记住,MFC的Iunknown支持是内建在CcmdTarget中的)变成了COM类。

ATL的类对象(以及IClassFactory)支持也来自模板,而MFC的类对象支持通过ColeObjectFactory和一些宏而有效。ATL的类对象支持来自CComCoClass/CcomClassFactory类家族和CcomCreator类家族。CcomCoClass包含了类的GUID,定义了COM类的错误处理设施。CcomCreator类提供了CreateInstance的实现,供CcomClassFactory使用。对于MFC,你可以通过若干宏,使所有这种支持有效。ATL包括 DECLARE_CLASS_FACTORY, DECLARE_CLASS_ FACTORY2, DECLARE_CLASS_FACTORY_AUTO_THREAD, 以及 DECLARE_CLASS_FACTORY_SINGLETON等宏用来使各种具体的类工厂支持有效。

最后,ATL 对IDispatch的支持还来自模板类,——其名字是IDispatchImpl.。比起MFC的Idispatch支持来,ATL对Idispatch的支持更加是COM中心的。MFC使用了一种hand-rolled 的IDispatch实现,而ATL使用更加标准的方法来加载一个接口的类型信息并代表标准的类型库编译器。

图2显示了一个标准的基于ATL的控件。最值得注意的一点是MFC和ATL各是怎样引入实现一个控件所需的必要的各种接口的。MFC对标准控件接口的支持是内建在ColeControl类中的。你从ColeControl中派生出你的控件并且一次性继承所有的函数调用。注意ATL通过模板继承以零碎的方式逐个引入每个功能片断。这是一个非常重要的差异,因为这意味着用ATL你可以忽略一些接口实现模板(例如,使你的控件更为精简)剥掉不希望的功能。对MFC,你不能完成同样的动作——不管你想不想,你将获得所有接口。

关于例子应用

这里我将使用的例子是一个通过一个分支过程监控消息流的ActiveX控件,它实时的显示消息流图。这两个控件实际上有着相同的功能。它们都把图表提交到屏幕。它们都带流入接口以便包容器能通知控件开始和停止该图表。它们都支持图表线的颜色和消息间隔长度作为属性而可以永久存在。最后,它们都支持缺省事件集,将关于在一个特定时间段里处理的消息的数量通知包容器。图3显示了这两个控件。

  

  Figure 3 监视 ActiveX 控件消息

用MFC开发一个控件

用MFC开发一个ActiveX控件涉及到在Visual Studio®.中使用ActiveX ControlWizard。为了开始一个新的控件,从File菜单中选择New,然后从工程类型列表中选择MFC ActiveX控件Wizard。首先,ControlWizard要求你决定在DLL中包括多少个控件。接着你就可以选择你打算怎样实现你的控件。

ControlWizard提供的第一批选项总体上适用于控件的DLL。它们包括了许可支持、源码注释和在线帮助。选择许可使得ControlWizard使用BEGIN_OLEFACTORY和END_OLEFACTORY (而非DECLARE__OLECREATE).。BEGIN_OLEFACTORY 和 END_OLEFACTORY宏覆盖了VerifyUserLicense和GetLicenseKey,因而为你的控件提供许可支持。请求ControlWizard包括注释将所有的TODO注释加入代码中。最后,请求ControlWizard包括在线帮助将为DLL创建样板HELP文件源代码。

一旦你通过了第一个对话框,ControlWizard就显示一个对话框用来配置DLL中的控件。这些配置选择包括使控件在运行时可见的选项,使得控件在可见时激活的选项,使得对象可以被插入的选项,给控件一个About框的选项,使得控件像一个简单的框架控件那样行为的选项。图4解释了不同的选项是如何影响ControlWizard生成的代码的。

ControlWizard还有一个将控件实现为一个标准的Windows控件的选项,就像一个编辑框或者一个按钮。这是一个有趣的选项。例如,如果你选择按照一个按钮将你的控件分成子类,控件的窗口实际上是一个按钮。此时,PreCreateWindow拦截控件的窗口创建,当创建控件的窗口时使用BUTTON窗口类。ControlWizard使你可以选择一些高级的选项,包括无窗口的激活,使你的控件具有完整的设备上下文,实现无抖动的激活,使你的控件在非激活状态也接受鼠标消息,使你的控件异步的加载自己的属性。这里有一个每个选项如何影响ControlWizard生成的代码的纲要。

无窗口的激活此选项覆盖COleControl::GetControlFlags,将windowlessActivate标志附加到控件标志中。一旦使此选项有效,包容器就将输入消息送交到控件的IoleInPlaceObjectWindowless接口。此接口ColeControl的实现通过你的消息映射分发消息。你就能通过简单的添加相应的入口到消息映射表,像处理一般windows消息那样处理消息了。

无省略的设备上下文选择了此选项覆盖COleControl::GetControlFlags,关闭clipPaintDC位,从而在ColeControl的 OnPaint函数中去掉了IntersectClipRect调用。如果你确定你的控件并不需要在客户区外部绘图,这个选项就有用了,因为使对IntersectClipRect的调用失效后,有一个明显的速度的提高。

无抖动的激活选择此选项覆盖COleControl::GetControlFlags,将缺省控件标志与noFlickerActivate逐位相或。控件在激活的时候检查此标志以阻止控件在激活和非激活状态转换时被重画。如果你的控件在激活和非激活状态外观一样,那么这个选项就是有用的。

非激活时的鼠标指针通知这个选项覆盖COleControl::GetControlFlags,附加了pointerInactive位。IpointerInactive接口使得一个对象大多数时间保持非激活,然而仍然参加与鼠标的某些操作的交互,例如拖放。

优化的绘图码 这个选项覆盖COleControl::GetControlFlags,打开canOptimizeDraw位,具有优化绘图代码的控件检查这个标志(通过COleControl’的IsOptimizedDraw函数)来确定控件是否需要在完成绘画后将旧的对象复原回设备上下文。

异步加载属性此选项将stock ReadyState属性和stock ReadyStateChange事件加入到控件中去。这将使得控件异步的加载其属性。例如,一个加载大量的数据作为其属性之一的控件会需要很长的时间来加载,而锁住了控件。这个stock属性和事件使得此控件立刻开始加载过程。包容器使用此事件和属性判断控件何时完成加载。

当ControlWizard完成这些事情后,你就得到了编译到一个包含此控件的DLL的源代码(扩展名是.OLX)。由wizard产生的源代码包括一个从ColeControlModule(它是从CwinApp中派生的)中派生的类。这个类包含整个控件模块的初始化代码。接着,wizard为基于ColeControl的表示每个控件的类生成源代码。最后,wizard生成一些ODL代码用来建立类型信息。

一旦wizard产生了控件DLL,你就面临完善这个控件的任务了。这意味着添加渲染代码,开发一个引入接口(方法和属性),rigging up属性页,展示某些事件。但是,在我向你说明所有这些都是如何工作之前,我们先来看一下使用ATL创建一个控件都需要什么。

用ATL开发一个控件

有了基于MFC的控件,你就可以用ATL COM App Wizard得到一个开发基于ATL的控件的触发器。使用ATL来创建控件可以分为两步。虽然MFC的Control Wizard要求你预先确定你希望在DLL中包含多少个控件,ATL COM Wizard简单的创建DLL——你可以以后使用ATL对象选项从Insert菜单添加控件。当创建一个新的基于ATL的DLL时,你可以选择混用MFC支持。你还可以选择在控件的DLL中合并任何proxy/stub代码。这使得如果有人希望远程控制你的控件实现的代码,你只要发布一个文件。

一旦生成了基于ATL的DLL,你就可以开始添加COM类了。Insert New ATL Object菜单条使得这项工作变得十分容易。选择此菜单项显示一个用来创建任何一个COM类的对话框,包括无格式的COM对象,ActiveX控件以及Microsoft事务服务器组件(Windows NT Server的一部分)。

当添加基于ATL的控件到你的工程的时候,ATL Object Wizard比MFC Object Wizard提供了更大范围的选项。对于新手来说,ATL使得你可以选择使用任何现有的线性模型实现你的控件。你可以将你的类标记为或者单线程或者单元线程的。ATL Object Wizard你创建一个自由的或者混合线程的控件,因为控件通常是面向UI的。

如果你创建了一个单线程的控件,一个包容的控件的客户将总是将它加载到主、单线程的单元(STA)中。结果,只有在客户进程空间运行的单主线程才会接触到你的对象,这样就免除了你保护你的控件状态不受并发访问干扰的责任。另外,因为你的对象的所有实例将只会被一个线程接触,你将不必担心DLL中的全局数据。如果你的控件是单元线程的,你还免除了保护你的控件的内部状态的大部分负担。然而,你仍然不得不保护DLL中的全局数据。为什么呢?首先,设想你的控件是由客户的单线程创建的。现在假定客户试图创建该控件的另一份拷贝——但是是从一个云向在当前进程的多线程的单元中。通过将你的对象标记为单元线程的,COM被告知你希望你的控件保护免遭并发访问。COM在它加载时为你的控件创建一个新的STA。现在当线程调用到你的对象时,它们只能通过单元边界来访问它,远程层将同步对此对象的调用。然而,当某个控件的状态被保护不被并发访问,作为在一个STA中的副产品,由控件的实例所共享的数据(象在DLL中的全局数据一样)是脆弱的。这是因为你的全局DLL数据(同时为几个对象服务,分别运行在的线程中)会被那些多线程同时接触到。

虽然基于MFC的COM类总是可聚合的(内置了对它的支持),ATL ObjectWizard使得你可以指定你的控件支持聚合,只是可聚合的,或者是的对象。根据你选择的聚合选项,ATL ObjectWizard使用一个宏来执行聚合策略。例如,缺省的COM类的实现是可聚合的——对象将既运行在的模式,又作为一个聚合的一部分。如果你使你的COM对象不可聚合,ObjectWizard把DECLARE_NOT_ AGGREGATABLE宏加到你的类定义中。如果你选择了仅是可聚合的,ObjectWizard把DECLARE_ ONLY_AGGREGATABLE宏加入到类定义中。

这里是宏如何工作的。缺省的对象创建在一个名为_CreatorClass的类中发生。_CreatorClass当被加入到服务器范围的对象映射后(这是OBJECT_ENTRY宏所做的工作的一部分),就成为你的COM类的创建机制。_CreatorClass其实只是一个名为CComCreator2类的别名,此类将两个从CcomCreator类中定制的类作为参数。此宏根据选择的聚合模式来特制CcomCreator类,分别使用CComObject, CComAggObject, CComFailCreator, 或者CcomPolyObject:

#define DECLARE_NOT_AGGREGATABLE(x) public: 

  typedef CComCreator2< CComCreator< CComObject< x > >,

  CComFailCreator > _CreatorClass;

#define DECLARE_AGGREGATABLE(x) public: 

  typedef CComCreator2< CComCreator< CComObject< x > >,

  CComCreator< CComAggObject< x > > > _CreatorClass;

#define DECLARE_ONLY_AGGREGATABLE(x) public: 

  typedef CComCreator2< CComFailCreator,

  CComCreator< CComAggObject< x > > > _CreatorClass;

#define DECLARE_POLY_AGGREGATABLE(x) public: 

  typedef CComCreator< CComPolyObject< x > > _CreatorClass;

  ATL ObjectWizard Attributes页中最后三个检查框包括对COM例外处理的支持(例如,IsupportErrorInfo接口),连接点以及自由线程集(FTM)。你也可以添加IsupportErrorInfo到控件的继承列表中,提供ISupportErrorInfo::InterfaceSupportsErrorInfo的一个实现。打开连接点将添加IConnectionPointImpl 模板类到控件的继承列表中。

将你的控件聚合到FTM使得单元间(以及Windows 2000的上下文间)的调用更为频繁的发生,如果两个对象正好位于同一个进程中。然而,你在编写控件时不应该检查这一点,因为当你使用FTM的时候,你多少都违反了单元(以及Windows 2000的上下文)规则。关于FTM的更多细节,请参见Don Box的Effective COM (Addison-Wesley Longman, 1998)一书。

除了你可以应用到所有COM对象的一般选项,ATL ObjectWizard还提供了几个控件创建特定的选项。首先,ATL ObjectWizard让你从一个常规控件(例如一个按钮或是一个编辑控件)中进行子类划分。你可以为你的空间指定其它几个选项使得它更加不透明,给它一个更实心的背景,在运行时不可见,或者是你的控件象一个按钮那样的工作。下面是控件属性页提供的选项的一个大纲:

不透明和实心背景如果你希望使所有的包容器都不显示在控件边界之后,选择"opaque"检查框,这是控件传给它的包容器的状态信息。结果是,控件在说明它将画出它的完整矩形。选择此选项设置VIEWSTATUS_OPAQUE位以便IViewObjectExImpl::GetViewStatus向包容器指示一个不透明的控件。你可能还想选择一个实心的背景。这个选项设置VIEWSTATUS_ SOLIDBKGND 位以便GetViewStatus指示控件有一个实心的背景。

运行时不可见此选项使你的控件在运行时不可见。你可以使用不可见控件在后台完成某些操作,例如周期性的激发事件。此选项在它加入到注册表中后使得控件翻转OLEMISC_INVISIBLEATRUNTIME 位。

仿按钮此选项使你的控件象一个按钮那样工作。此时,控件将在包容器周围属性DisplayAsDefault的基础上显示为缺省的按钮。如果控件的位置标记为缺省按钮,控件将显示为一个较厚的框架。选择此选项在它加入到注册表中后使得控件翻转OLEMISC_ACTSLIKEBUTTON 。

仿标签选择此选项使得你的控件取代包容器的内部标签。这使得控件在它加入到注册表中后标记OLEMISC_ACTSLIKELABEL。

在超类基础上添加控件选择此选项使得你的控件根据一种标准window类进行子类划分。下拉列表包含了Windows定义的window类。当你选择这些类名中的一个时,向导添加一个CcontainedWindow成员变量到你的控件类中。CContainedWindow::Create将你指定的window类超类化。

规格化DC选择此选项使得你的控件在被调用来画自己时创建一个规格化的设备上下文。这标准化了控件的外观,但是效率降低了。此选项生成的代码覆盖了OnDrawAdvanced方法(而不是常规的OnDraw方法)。

可插入的选择此选项使得你的控件显示在象Microsoft Excel 和Word 这样的应用的Insert Object对话框中。你的控件就能够被插入到任何支持嵌入对象的应用中了。选择此选项在注册表项中增加了Insertable键。

仅为窗口化的选择此选项迫使你的控件窗口化,即使在支持无窗口对象的包容器中。如果你不选择此选项,你的控件将会自动的适应包容器:在支持无窗口对象的包容器中是无窗口的,在不支持无窗口对象的包容器中是有窗口的。这将使CComControlBase::m_bWindowOnly标志设置为TRUE。ATL使用此标志来决定在控件激活过程中是否要查询包容器的IoleInPlaceSiteWindowless接口。

ATL要求你预先在Stock Properties页中决定你的对象的stock属性,你可以选择Caption或者 Border Color这样的属性,或者通过点击>>按钮一次性选择所有的stock属性。这将向控件的属性映射中添加属性。

在运行ATL COM App Wizard 和 ObjectWizard之后,你就得到了一个完整的DLL,它具有一个COM DLL所必需的所有分支。此控件显示的众所周知的出口包括DllGetClassObject, DllCanUnloadNow, DllRegisterServer,和 DllUnregisterServer。另外,你得到了一个满足COM主要需求的对象——包括一个主流入接口和一个类对象。

一旦你已经使用一个向导开始了一个工程,下一步就是使控件做点有趣的事情了。通常出发点是控件的翻译代码。你立刻得到一些可视化的反馈。让我们来看一下一个基于MFC的控件的翻译是怎样发生的。

控件翻译

MFC和ATL在翻译处理上是相似的。在每一个框架里,实现控件的类具有一个名为OnDraw的虚函数。你只需将你的翻译代码添加到OnDraw函数里。然而,在各框架里,OnDraw函数得工作有所不同。

MFC的OnDraw在两种上下文下调用。第一个上下文发生在控件响应一个WM_PAINT消息时。此时,传递给OnDraw函数的设备上下文代表了真实的设备上下文。如果控件正被要求render它自己作为对客户调用IViewObjectEx::Draw的响应,设备上下文或者是一个元设备上下文,或者是一个常规设备上下文。下面的代码说明了基于MFC的控件是怎样被render的:

void CMFCMsgTrafficCtrl::OnDraw(CDC* pdc, const CRect& rcBounds,

  const CRect& rcInvalid)

{

  // TODO: 用你自己的绘图代码代替下面的代码

  pdc->FillRect(rcBounds,

  CBrush::FromHandle((HBRUSH)GetStockObject(WHITE_BRUSH)));

  ShowGraph(*pdc, const_cast(rcBounds), nMessagesToShow);

}

COleControl::OnDraw的签名包括一个代表控件大小的矩形和一个代表控件非法区域的矩形。MFC调用控件的OnDraw函数来响应一个WM_PAINT消息。此时,OnDraw函数接受一个真实的设备上下文来绘图。MFC还调用控件的OnDraw函数来响应IViewObject::Draw中的一个调用。MFC的实现调用COleControl::OnDrawMetafile,它的缺省OnDrawMetafile调用COleControl::OnDraw。当然,这暗示了控件的实时翻译是与控件的元文件表示相同的,该元文件在设计时与包容器一块存储。你可以使得控件的实时的翻译与设计时的翻译不同,这通过重载COleControl::OnDrawMetafile来实现。通过调用你的控件的InvalidateControl方法,你可以强制进行一个重绘。ATL的翻译机制非常类似于MFC。CComControlBase::OnPaint建立一个ATL_DRAWINFO结构,包括创建一个绘图设备上下文。然后ATL调用控件的OnDrawAdvanced函数。OnDrawAdvanced生成元文件,接着调用你的控件的OnDraw方法,它使用ATL_DRAWINFO结构中的信息来知道怎样在屏幕上绘图。下面是ATL_DRAWINFO结构:

struct ATL_DRAWINFO

{

  UINT cbSize;

  DWORD dwDrawAspect;

  LONG lindex;

  DVTARGETDEVICE* ptd;

  HDC hicTargetDev;

  HDC hdcDraw;

  LPCRECTL prcBounds; //在其中绘图的矩形

  LPCRECTL prcWBounds; //WindowOrg and Ext if metafile

  BOOL bOptimize;

  BOOL bZoomed;

  BOOL bRectInHimetric;

  SIZEL ZoomNum;    //ZoomX = ZoomNum.cx/ZoomNum.cy

  SIZEL ZoomDen;

};

ATL为你填写此结构。当你正在屏幕上绘图时,你所感兴趣的最重要的域是hdcDraw 和 prcBounds。如果你对在一个元文件里绘图感兴趣,或者你需要注意缩放因子等等,那么其它域也是重要的。下面的代码显示了基于ATL的消息流控件是怎样处理绘图的:

HRESULT CATLMsgTrafficCtl::OnDraw(ATL_DRAWINFO& di)

{

  RECT& rc = *(RECT*)di.prcBounds;

  HBRUSH hBrush = CreateSolidBrush(RGB(255, 255, 255));

  FillRect(di.hdcDraw, &rc, hBrush);

  DeleteObject(hBrush);

  Rectangle(di.hdcDraw, rc.left, rc.top, rc.right, rc.bottom);

  ShowGraph(di.hdcDraw, rc, nMessagesToShow);

  return S_OK;

}

注意当你使用ATL的时候,你必须处理设备和GDI句柄。在ATL中,你调用你的控件的FireViewChange函数来强制控件的一次重画。

开发一个流入接口

当开发一个基于MFC的ActiveX控件时,缺省的流入接口是一个分发接口。Visual C++ 和 MFC使得开发一个流入分发接口变得十分简单——只需使用ClassWizard来生成方法和属性。每次你使用ClassWizard添加一个新的属性或方法,它就插入一个入口到你的控件的分发映射中。MFC使用分发映射来满足客户的调用请求。

MFC的缺点是在你的控件中增加一个常规的COM接口是一个枯燥无味的过程。此过程包括使用MFC的COM宏来建立实现接口的嵌套的类。

当为你的基于ATL的COM控件开发主流入接口时,类视是添加属性和方法的最好的手段。一当你为控件生成了代码,ATL ObjectWizard即添加一个缺省的流入接口。这可以是一个双端接口,也可以是一个常规的自定义接口,取决于你先前设定的工程选项。

Visual Studio的类视向你显示了你的工程中包含的所有的类和接口,在类视中右击一个接口的定义时,即可添加一个属性或者方法。使用类视来定义接口非常方便,因为每次你添加一个方法或者属性的时候,类视都会更新IDL,类源代码以及头文件。

不象MFC,给控件添加一个常规COM接口是非常容易的。在ATL中,你只要简单的添加新的接口样板文件连接(goo)(一个GUID,关键字对象和关键字接口)。类视将会显示新的接口,你可以继续添加新的成员。

添加属性

一个ActiveX控件经常包含属性,它们是描述控件的状态的成员变量。给一个基于MFC的控件添加属性的最好的手段是利用ClassWizard。ClassWizard的自动为你添加成员变量,将它们映射到缺省的分发接口。ClassWizard给你提供了两种选择:你可以添加一个成员变量,包括一个变化通告函数,或者你可以添加一对Get/Set函数,手动的添加成员变量。除了给控件添加你自己的定制属性,ClassWizard使你象添加背景和标题一样的添加库存。ClassWizard甚至自动为你的类添加一个成员变量。

为一个基于ATL的控件添加属性有一点不同,你为控件中的每个属性添加单独的存取程序和变异因子函数(propget 和 propput函数)。然而,类视只是定义了接口函数。你还要手工添加数据成员到类中,然后简单的实现这些函数。

基于ATL的控件还支持stock属性,ATL ControlWizard预先要求你确定希望哪些stock属性包括在你的控件中。添加至少一个stock属性到控件中使得控件继承自ATL的CstockPropImpl类。CstockPropImpl是Idispatch的一个实现,优化来显示ActiveX控件的stock属性,为每个标准的stock属性包含了兼容Idispatch的get 和 put函数。

ControlWizard还给控件添加代表stock属性的数据成员,例如,如果你添加了背景颜色的stock属性,ControlWizard添加一个名为m_clrBackColor的数据成员到你的类中。CstockPropImple一次性的为所有标准的stock属性的get 和 put函数添加实现。所有这些函数期望在你的类中看到合适的成员变量(象对应背景颜色的m_clrBackColor)。

编译器将在stock属性没有包括的那些get和put函数上阻塞。实现过程希望在你的类中看到成员变量。为了消除编译器错误,CcomControlBase添加了一个联合结构,它包括了stock的get 和 put函数希望看到的所有成员的名字。然而,给控件添加数据成员重载了联合类型中的名字,CstopPropImpl类在它的get 和 put函数中使用控件的成员变量

如果你忘记了使用ControlWizard预先添加stock属性,你总可以手工添加相关代码——即,从CstockPropImpl继承,然后为你想要显示的属性添加成员变量。

属性持续

MFC的属性持续机制是非常直观易懂的。从编程的观点来看,所有你要做的是填写ControlWizard已经提供的DoPropExchange函数。DoPropExchange将控件属性的状态从某些成员变量移动到持续媒体中。

MFC具有3个属性持续机制,内置于ColeControl:IPersistPropertyBag, IPersistStorage和 IPersistStream[Init]。所有这些持续机制都封装在MFC的CpropExchange类中,与当你需要serialize 一个文档时Carchive为你包装一个文件非常相似。客户方选择使用3个接口中的一个保持对象。不管使用了哪种持续机制,执行总落在控件的DoPropExchange函数中。

下面的代码显示了MFCMsgTraffic控件是怎样将它的颜色和时间间隔属性保存起来的:

void CMFCMsgTrafficCtrl::DoPropExchange(CPropExchange* pPX)

{

  ExchangeVersion(pPX, MAKELONG(_wVerMinor, _wVerMajor));

  COleControl::DoPropExchange(pPX);

  PX_Color(pPX, "GraphLineColor", m_graphLineColor);

  PX_Long(pPX, "GraphInterval", m_interval);

}

  MFC包括了若干PX_函数在控件和存储媒体间转移数据,它们是:

PX_Short

PX_UShort

PX_Long

PX_ULong

PX_Color

PX_Bool

PX_String

PX_Currency

PX_Float

PX_Double

PX_Blob

PX_Font

PX_Picture

PX_IUnknown

PX_VBXFontConvert

PX_DataPath

在ATL中管理控件属性持续涉及到两个步骤。第一步是添加你希望客户能够使用的持续接口的ATL实现。ATL包括了类IPersistStorageImpl, IPersistStreamInitImpl, 和 IPersistPropertyBagImpl, 它们实现了三个主COM持续机制。

第二步是在控件的属性映射中插入属性。当一个客户请求保存或者加载基于ATL的控件时,ATL检查控件的属性映射表,将控件的属性输出到存储媒介,或者从存储媒介输入。属性映射表是属性名字、DISPIDs的一个表,有时还包括一个属性页面GUID。ATL遍历词表查找该持续哪个属性,并将其持续到合适的媒体。图5显示了继承了持续接口实现和一个属性映射的ATLMsgTraffic控件。

属性页

ActiveX控件经常在开发者将控件放到各类容器时提供属性页帮助开发者。将消息流控件放入一个对话框的开发者可能想要配置控件的各个方面,象控件的取样间隔,或者绘图线条的颜色。例如,当控件放在一个对话框中,你想通过右击鼠标得到控件的属性时,Visual Studio显示了一个突出的对话框。这里将说明其工作过程。

Visual Studio请求控件在一个对话框框架里显示属性页(Visual Studio IspecifyPropertyPages接口请求控件提供一个属性页的清单),属性页显示在Visual Studio中,但是通过控件提供的一个COM接口,保持与控件的连接。每当你完成了属性编辑并从Visual Studio中关闭了对话框,它就会要求属性页更新控件中的属性。

当你生成一个MFC的控件时,wizard给你一个对话框模板和一个从ColePropertyPage中派生的代表此控件的缺省属性页的类。Visual Studio使得实现一个控件的属性和此属性页中的属性的连接变得容易了。当你使用ControlWizard的Automation tab添加属性到你的基于MFC的控件中的时候,你给了属性一个外部名字。这个名字是外部客户方(包括属性页)用来识别该属性的。

你按照开发其它任何对话框的方法来开发属性页——将控件添加到对话框模板,将对话框成员变量和控件联系起来。ControlWizard添加DDX/DDV代码在对话框控件和成员变量之间交换数据。然而,当你将成员变量和对话框控件相关联时,ControlWizard给你提供了这样一个机会,你可以将外部属性名字用于对话框的成员变量。此外部名字是你给控件添加属性时键入的字符串。

当属性页需要将变化应用于控件时(例如当按下Apply按钮时),属性页使用控件的Idispatch接口以及外部名字来修改控件的属性。在MFC中,你可以通过ClassWizard来添加一个新属性,添加一个新的对话框模板到工程中,让ClassWizard创建一个类——要确保是从ColePropertyPage中派生出来的类。然后,为了使新的属性页可以被外界访问到,将它的GUID添加到控件的属性页映射中(在控件的.CPP文件中查找BEGIN_ PROPPAGEIDS 和 END_PROPPAGEIDS两个宏)。不象MFC的ActiveX ControlWizard,ATL COM App Wizard并不向DLL中添加缺省的属性页。这意味着你要自己完成此工作。幸运的是,又一个wizard可以向属性页中添加基于ATL的DLL。只要选择Insert ATL Object,然后找到属性页对象。Wizard将一个对话框模板和一个C++类与所有必要的COM goo一起添加到一个属性页中。让它们完成什么工作是你的事情。

不幸的是,ATL属性页的wizard驱动特性不如基于MFC的属性页,你得手工完成应用和显示操作。这就意味着提供Apply 和 Show的函数实现到你的属性页类中。Apply函数只是提取对话框中控件的状态,遍历属性页拥有的指向控件的接口指针列表,使用接口指针来修改控件属性。Show函数通常提取控件的状态,然后以次来组织对话框的控件。下面的代码显示了基于ATL的属性页是怎样处理Apply函数的:

STDMETHOD(Apply)(void)

{

  long nInterval = GetDlgItemInt(IDC_EDITINTERVAL);

  ATLTRACE(_T("CMainPropPage::Apply "));

  for (UINT i = 0; i < m_nObjects; i++)

  {

    IATLMsgTrafficCtl* pATLMsgTrafficCtl;

    m_ppUnk[i]->QueryInterface(IID_IATLMsgTrafficCtl,

                  (void**)&pATLMsgTrafficCtl);

    if(pATLMsgTrafficCtl) {

      pATLMsgTrafficCtl->put_Interval(nInterval);

      pATLMsgTrafficCtl->Release();

    }

  }

  m_bDirty = FALSE;

  return S_OK;

}

为基于ATL的控件提供一个属性页的第二步是确保属性页的CLSID出现在控件的属性映射中,图5中列出的属性持续代码提供了它的一个例子。消息映射表明了控件的图线颜色,被标准的颜色属性页管理。控件的取样间隔由控件的主属性页来管理。

Window 消息

MFC和ATL在它们处理window消息方面有很多共同之处,都使用消息映射,都有wizards来生成代码处理window消息。在MFC中,消息映射可以添加到任何一个CcmdTarget派生的类中,然后你就可以用ClassWizard来建立你的控件的事件处理器了。图6显示了基于MFC的控件怎样处理WM_ TIMER消息。另外,MFC提供了处理命令和控件通告的宏。象MFC一样,ATL通过消息映射来处理window消息,只要你的类是从CwindowImpl派生的,而且包含ATL的消息映射宏,你就可以使用类视来建立事件处理器。图7显示了ATL消息流控制是怎样处理WM_TIMER消息的。

ATL使用MESSAGE_HANDLER宏将标准的window消息映射到一个C++类。此宏简单的产生一个将window消息和类的成员函数关联的表。除了常规消息,消息映射还可以处理其它类型的事件。图8显示了能参与消息映射的各种宏。

连接和事件

最后要进行的比较是MFC和ATL各是怎样处理连接点和事件集的。为了管理连接点和事件集,需要一个COM类来实现IconnectionPointContainer,然后创建一种提供指向IconnectionPoint的指针给客户的方法。MFC的主控件类,ColeControl,已经有了内置的IconnectionPointContainer,MFC通过连接映射提供了连接点。MFC已经为IPropertyNotifySink定义了连接点和控件的缺省事件集。

为了完善一个基于MFC的控件的缺省事件集,你只要简单的使用ClassWizard’s ActiveX Event tab。在你使用ClassWizard添加事件的时候,Visual Studio更新你的控件的.ODL文件,为潜在的包容器描述外出事件。另外,Visual Studio添加一个函数到你的类中,你可以调用它反过来向包容器激发事件。图9演示了基于MFC的控件的事件触发机制。基于MFC的控件的事件触发函数只是由包容器在它和控件建立连接点时提供的一个Idispatch指针的一些简单的包裹器。

在基于ATL的控件中建立事件则有所不同。在基于ATL的控件中,你从定义控件的.IDL文件中的事件开始。接着你建立了类型库的编译工程文件。图10显示了在IDL中描述的基于ATL的控件的事件集。

一但类型库编译通过,你就可以通过在类视中选择控件的类,在类上右击,然后选择Implement Connection Point,让类视来为你创建一个回调代理了。Visual Studio弹出一个对话框,列出控件类型库中所有可访问的事件接口。你选择那些你希望回调代理做的,Visual Studio就为你写一个代理。图11显示了基于ATL的消息流控制的回调代理。Visual Studio产生的回调代理代表了一个C++友好的函数集,被客户实现的接口所调用。

MFC的IconnectionPointContainer实现是硬分布到ColeControl中,并且每个连接点是由一个连接映射处理的,而ATL的实现是用多重继承处理的。你的控件类继承IconnectionPointContainerImpl和类视生成的代理。如果你开始一个工程的时候,选择了"Supports connection points",ObjectWizard就为你添加IconnectionPointContainerImpl。如果你忘了标记检查框,你可以写进去。此代码显示了连接点机制是怎样加入一个控件中的。类ATL_NO_VTABLE CATLMsgTrafficCtl :

{

•••

  public IConnectionPointContainerImpl,

  public CProxy_DATLMsgTrafficEvents

•••

  {

  LRESULT OnTimer(UINT msg, WPARAM wParam,

          LPARAM lParam,

          BOOL& bHandled) {

  //•••

    if(nMessagesToShow > m_threshold)

    {

      Fire_ExceededThreshold(nMessagesToShow, m_threshold);

    }

  //•••

  }

};

  作为一个应用框架ATL和MFC的比较

最近,许多开发者开始对使用ATL作为框架来开发应用和控件感兴趣了。当然,MFC已经使用了很长时间了,是一个能够开发可双击的基于Windows的应用的非常成熟的框架。例如,MFC包括了这样的特性作为一个总体文档/视体系结构:Object Linking 和 Embedding支持, 以及工具条和状态栏。

然而,所有这些功能都是有代价的。一些更加普遍的抱怨是MFC的比较深的足迹(无论是在DLL中,或是在静态连接的版本中),以及自身的某种相互依存性。例如,买入MFC的一种特性意味着买入MFC的对象连接和嵌入,这意味着买入MFC的文档/视结构。另一方面,ATL是一个原始的框架,没有任何应用框架goodies。

正象你已经看到的,两个框架都提供创建控件的可行途径。然而,两者都各有千秋,也各有弊病。用MFC编写控件通常更加容易——尤其是如果你不是在开发COM集中的应用并且你需要windowing和drawing支持。ATL的体系架构更加靠近COM的核心,你还会经常发现自己在编写很多的SDK类型的代码——就是说,你在回过头来用window和设备上下文句柄。ATL为更广范围的控件类型提供了很大的支持,象复合控件,基于HTML的控件,没有design-time接口的轻量级的控件等等。MFC仅提供完全成熟的控件。

对ATL进行分支的实现是非常直接的。例如,增加一个接口通常是一件添加接口到继承表,在COM映射中添加一个入口然后实现接口函数的工作。分支MFC的实现通常是一种折磨。例如,添加一个接口到基于MFC的控件意味着处理所有那些接口映射宏。

最后,ATL提供了大量的调试支持,包括接口引用计数以及QueryInterface调试支持,这在MFC中是没有的。

这两种体系架构的区别是非常明显的。通常,MFC使得你很快完成你的工程并更快的运行起来,但是牺牲了灵活性。ATL没有那样快,那样容易使用,但是它是COM友好的。而且,好像随着ATL的成熟,它将会越来越容易使用。下载本文

显示全文
专题