MFC开发COM控件(1) ODL

// COMs8MFCDual.odl : type library source for ActiveX Control project.
// 控件的类型库

// This file will be processed by the Make Type Library (mktyplib) tool to
// produce the type library (COMs8MFCDual.tlb) that will become a resource in
// COMs8MFCDual.ocx. 此文件将被MIDL处理以产生类型库文件,该类型库将作为一种资源存在
// 于.ocx控件中

//有关MIDL语言的信息请参考 《COM+开发人员参考库之第1卷第19章.TIF》

#include <olectl.h>    //ole2.0 control interface
#include <idispids.h> 
/*
可以使用C语言预处理指令#include，在你的IDL或ODL文件中包含头文件和其他文件。
但我们应该注意: 这一指令会在字面上包含指定文件的全部内容。
如果头文件包含在MIDL生成的存根文件中有不需要或者不想用的原形，或者包含非远程类型定义，
则应该使用MIDL的import指令代替#include指令
*/

//uuid 指定类型库、coclass或者接口的唯一标识
[ uuid(D3622FC9-19F5-400A-945A-018B0B07595D),  //标识了类型库
  version(1.0), //指定类型库的特定版本
  helpfile("COMs8MFCDual.hlp"), //为类型库设置Help文件的名称
  helpstring("COMs8MFCDual ActiveX Control module"), //将帮助串放入类型库
  control ] //将coclass或library看成COM控件,容器位置可以由
  //它得到附加类型库或者组件对象类
library COMS8MFCDUALLib  
//当MIDL遇到 library 关键字时，它将自动生成一个类型库,即通知MIDL编译器为接口和语句
//中引用到的类生成类型信息
/*
生成.tlb后，你可以单独发行，也可以作为一种资源包含在.exe/.ocx/.dll中,
大多数情况下，我们将其作为一种资源。
*/

{
/*
#define STDOLE_TLB "stdole2.tlb"
#ifdef _WIN64
#define STDTYPE_TLB "stdole2.tlb"
#else
#define STDTYPE_TLB "olepro32.dll"
#endif
*/
 importlib(STDOLE_TLB);
 /*
 STDOLE_TLB 是将windows操作系统下的/system32目录下的 stdole2.tlb 类型库导入
 */
 importlib(STDTYPE_TLB);
 /*
 STDTYPE_TLB
 */
/*
importlib 指令允许引用IDL或ODL文件中已编译的类型库。Importlib指令必须在library语句中，
而且必须在库中其他类型描述之前。导入库和生成的库一样，在应用程序运行时必须存在。
*/

/*
// {050B7561-65D0-405b-822D-B0708AE27CF5}
IMPLEMENT_OLECREATE(<<class>>, <<external_name>>,
0x50b7561, 0x65d0, 0x405b, 0x82, 0x2d, 0xb0, 0x70, 0x8a, 0xe2, 0x7c, 0xf5);
*/
   [ uuid(050B7561-65D0-405b-822D-B0708AE27CF5),
     helpstring("Double interface"), //helpstring 指定一个字符串,用来描述其将要应用的元素
     oleautomation, //指出接口是与自动化兼容的
     dual ] //识别通过IDispatch拥有属性和方法的接口,并直接通过vtable
    interface IInnerDual : IDispatch //继承自IDispatch，IInnerDual是一个自动化接口
    {
        [propput, id(1)] HRESULT Hello([in] BSTR newText);
  /*
  in关键字告诉MIDL: 需要将此参数值从客户传递给组件，存根代码不需要送回任何值
  */
        [propget, id(1)] HRESULT Hello([out, retval] BSTR* ret);
  /*
  out关键字告诉MIDL: 参数仅被用来从组件向客户传回有关的数据,
  代理不需要对输出参数进行列集，也不需要将参数传给组件
  */
        [id(2)] HRESULT SayHello(BSTR strHello);
  //propput 指定属性设置函数
  //propget 指定属性访问函数
    }
/*
 自动化技术直接以COM为基础,所有的自动化对象都实现了 IDispatch 接口,通过其暴露
 属性和方法,以便在客户程序中使用这些属性和方法。客户程序通过类型库(tlb)获得对象
 运行时刻的类型信息，其对对象属性和方法的引用实际上被转化为对 IDispatch::Invoke
 的调用。
*/

 //  Primary dispatch interface for CCOMs8MFCDualCtrl

 [ uuid(F5711E23-3746-451A-BDE8-C8D97B9BA31C),
   helpstring("Dispatch interface for COMs8MFCDual Control"), hidden ]
   /*保持与现有代码兼容的同时,从接口中删除成员*/
 dispinterface _DCOMs8MFCDual
 {
  properties:
   // NOTE - ClassWizard will maintain property information here.
   //    Use extreme caution when editing this section.
   //{{AFX_ODL_PROP(CCOMs8MFCDualCtrl)
   [id(1)] BSTR Hello;
   //}}AFX_ODL_PROP

  methods:
   // NOTE - ClassWizard will maintain method information here.
   //    Use extreme caution when editing this section.
   //{{AFX_ODL_METHOD(CCOMs8MFCDualCtrl)
   [id(2)] void SayHello(BSTR strHello);
   //}}AFX_ODL_METHOD

   [id(DISPID_ABOUTBOX)] void AboutBox();
 };

 //  Event dispatch interface for CCOMs8MFCDualCtrl

 [ uuid(187E757F-FAF6-462A-A2A1-B1AB20A1317E),
   helpstring("Event interface for COMs8MFCDual Control") ]
 dispinterface _DCOMs8MFCDualEvents
 {
  properties:
   //  Event interface has no properties

  methods:
   // NOTE - ClassWizard will maintain event information here.
   //    Use extreme caution when editing this section.
   //{{AFX_ODL_EVENT(CCOMs8MFCDualCtrl)
   //}}AFX_ODL_EVENT
 };

 //  Class information for CCOMs8MFCDualCtrl
 // 由于一个自动化对象可以支持多个自动化接口，所以我们使用 [default] 描述符
 // 以便显式指定缺省接口
 [ uuid(5D33FEBD-854F-4F25-ACBC-B551936A7FD7), //CLSID
   helpstring("COMs8MFCDual Control"), control ]
   //coclass 提供组件对象支持的接口列表
 coclass COMs8MFCDual  //定义了真正的自动化组件对象,该关键字用来定义一个组件
 { 
 // [default] dispinterface _DCOMs8MFCDual;
 // [default, source] dispinterface _DCOMs8MFCDualEvents;
        [default] interface IInnerDual;  //default 提供缺省接口
        [default, source] dispinterface _DCOMs8MFCDualEvents;
  //source 指定coclass、属性、方法的成员为事件源
        dispinterface _DCOMs8MFCDual;
  //dispinterface 定义一个属性和方法集,在此集合中可以调用
  //IDispatch::Invoke
 };

 //{{AFX_APPEND_ODL}}
 //}}AFX_APPEND_ODL}}
};