向一个类中添加某个接口的实现,这是很常见的需求,特别是用在事件通知、连接点中更是多见。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到父类中去找,以此类推。跟消息映射的处理方法是一样的。  
说明:本教程来源互联网或网友上传或出版商,仅为学习研究或媒体推广,wanshiok.com不保证资料的完整性。
|