向CCmdTarget的派生类添加一个接口的实现

向一个类中添加某个接口的实现，这是很常见的需求，特别是用在事件通知、连接点中更是多见。MFC类库内的很多类也都有这样的需求，比如类COleControl就实现了很多的接口。MFC自己实现的方法都用的是嵌套类，并且定义了几个宏来简化该过程。用同样的方法，我们也可以很方便的在自己的类中添加一个接口的实现。CCmdTarget中实现了接口IDispatch，以及IUnknown 的三个函数的缺省实现。一般的MFC类都会从CCmdTarget继承，所以这里讲的是典型的向CCmdTarget的派生类添加接口的方法。

　　比如，有一个类CSampleView从CView中继承。现在要给它添加一个新的接口IMyTest，该接口只有一个空的方法Test()。添加过程如下：

(1)CSampleView类定义中加入以下代码：

DECLARE_INTERFACE_MAP() //声明接口映射 　　　　BEGIN_INTERFACE_PART(TestInterface, IMyTest) //声明实现接口IMyTest的嵌套类 　　　　　　　　STDMETHOD(Test)(); 　　　　END_INTERFACE_PART(FontNotify2)

(2)CSampleView类实现中加入以下代码：

BEGIN_INTERFACE_MAP(CSampleView, CCmdTarget) 　　　　　　　　INTERFACE_PART(CSampleView, IID_IMyTest, TestInterface) 　　　　END_INTERFACE_MAP() 　　　　STDMETHODIMP_(ULONG) CSampleView::XTestInterface::AddRef( ) 　　　　{ 　　　　　　　　METHOD_PROLOGUE_EX(CSampleView, TestInterface) 　　　　　　　　return (ULONG)pThis->ExternalAddRef(); 　　　　} 　　　　STDMETHODIMP_(ULONG) CSampleView::XTestInterface::Release( ) 　　　　{ 　　　　　　　　METHOD_PROLOGUE_EX(CSampleView, TestInterface) 　　　　　　　　return (ULONG)pThis->ExternalRelease(); 　　　　} 　　　　STDMETHODIMP CSampleView::XTestInterface::QueryInterface( REFIID iid, LPVOID FAR* ppvObj ) 　　　　{ 　　　　　　　　METHOD_PROLOGUE_EX(CSampleView, TestInterface) 　　　　　　　　return (HRESULT)pThis->ExternalQueryInterface(&iid, ppvObj) ; 　　　　} 　　　　STDMETHODIMP CSampleView::XTestInterface::Test() 　　　　{ 　　　　　　　　METHOD_PROLOGUE_EX(CSampleView, TestInterface) 　　　　　　　　// do something you like 　　　　　　　　return S_OK ; 　　　　}

　　揭开宏的神秘面纱，看看它到底是什么东西。以下都是简化的版本。

(1)DECLARE_INTERFACE_MAP

struct AFX_INTERFACEMAP_ENTRY { 　　　　const void* piid; 　　　　// the interface id (IID) (NULL for aggregate) 　　　　size_t nOffset; 　　　　// offset of the interface vtable from m_unknown }; struct AFX_INTERFACEMAP { 　　　　const AFX_INTERFACEMAP* (PASCAL* pfnGetBaseMap)(); // NULL is root class 　　　　const AFX_INTERFACEMAP_ENTRY* pEntry; // map for this class }; #define DECLARE_INTERFACE_MAP() / private: / 　　　　static const AFX_INTERFACEMAP_ENTRY _interfaceEntries[]; / protected: / 　　　　static AFX_DATA const AFX_INTERFACEMAP interfaceMap; / 　　　　static const AFX_INTERFACEMAP* PASCAL _GetBaseInterfaceMap(); / 　　　　virtual const AFX_INTERFACEMAP* GetInterfaceMap() const; /

(2)BEGIN_INTERFACE_PART/END_INTERFACE_PART

#define BEGIN_INTERFACE_PART(localClass, baseClass) /// 定义了一个嵌套类 　　　　class X##localClass : public baseClass / 　　　　{ / 　　　　public: / 　　　　　　　　STDMETHOD_(ULONG, AddRef)(); / 　　　　　　　　STDMETHOD_(ULONG, Release)(); / 　　　　　　　　STDMETHOD(QueryInterface)(REFIID iid, LPVOID* ppvObj); / #define END_INTERFACE_PART(localClass) / 　　　　} m_x##localClass; / 　　　　friend class X##localClass; /

(3)BEGIN_INTERFACE_MAP/INTERFACE_PART/END_INTERFACE_MAP

#define offsetof(s,m) (size_t)&(((s *)0)->m) #define BEGIN_INTERFACE_MAP(theClass, theBase) / 　　　　const AFX_INTERFACEMAP* PASCAL theClass::_GetBaseInterfaceMap() / 　　　　　　　　{ return &theBase::interfaceMap; } / 　　　　const AFX_INTERFACEMAP* theClass::GetInterfaceMap() const / 　　　　　　　　{ return &theClass::interfaceMap; } / 　　　　AFX_COMDAT const AFX_DATADEF AFX_INTERFACEMAP theClass::interfaceMap = / 　　　　　　　　{ &theClass::_GetBaseInterfaceMap, &theClass::_interfaceEntries[0], }; / 　　　　AFX_COMDAT const AFX_DATADEF AFX_INTERFACEMAP_ENTRY theClass::_interfaceEntries[] = / 　　　　{ / #define INTERFACE_PART(theClass, iid, localClass) / 　　　　　　　　{ &iid, offsetof(theClass, m_x##localClass) }, / #define END_INTERFACE_MAP() / 　　　　　　　　{ NULL, (size_t)-1 } / 　　　　}; /

(4)METHOD_PROLOGUE_EX

#define METHOD_PROLOGUE_EX(theClass, localClass) / 　　　　METHOD_PROLOGUE(theClass, localClass) / #define METHOD_PROLOGUE(theClass, localClass) / 　　　　theClass* pThis = / 　　　　　　　　((theClass*)((BYTE*)this - offsetof(theClass, m_x##localClass))); / 　　　　AFX_MANAGE_STATE(pThis->m_pModuleState) / 　　　　pThis; // avoid warning from compiler /

　　METHOD_PROLOGUE最大的作用就是得到pThis指针。该宏用在嵌套类的成员函数中，pThis是其父类的指针，这里也即是CSampleView的this指针。

　　这些宏与MFC中的消息映射宏非常的相似，在侯捷的《深入浅出MFC》中对消息映射宏有非常详细的讲述。我也无意画蛇添足。它的基本思想就是把各个嵌套类的对象(即m_x开头的变量)放到一个数组里，这样在QueryInterface时就可以得到这些接口的指针了，所谓的接口指针也就是这些嵌套类对象的地址。

　　也可以用下图简单的说明一下它的结构(并不精确，只说明一下意思)：

CCmdTarget包含了三个函数：ExternalAddRef、ExternalRelease、ExternalQueryInterface。这样我们就不用自己实现IUnknown接口了，只要简单地调用父类的函数就可以了，这实在是很方便。ExternalQueryInterface的执行过程就是先在子类中找要查询的接口，如果找到了就返回其接口指针。如果找不到就通过GetBaseInterfaceMap到父类中去找，以此类推。跟消息映射的处理方法是一样的。感兴趣的话就自己去看下源码吧。

　　基本上已经清楚了，实际上知道怎么用就可以了，对其内幕稍微了解一下也就可以了。宏的功能实在是强大，我觉得这也是C++的魅力之一。不知道为什么有人反对使用宏，不要跟我讲一通宏的种种缺点，那不是宏的问题，而只是你自己的问题。：）