Win32编程点滴3 - 简单ActiveX控件的使用

来源:互联网 发布:王使屈平为令众莫不知 编辑:程序博客网 时间:2024/06/03 14:12

文字来源:http://www.cnblogs.com/Greatest/archive/2009/09/03/1559533.html

虽然这里一片的.net气氛,到处充斥着像MVC、WPF、WorkFlow、LINQ等各种niubility的术语。但我们使用的Windows还是由COM技术主宰着;我们在选择日常使用的软件时,也会避免使用.net开发的软件。即便是.net的桌面程序,也会经常使用ActiveX控件。这篇文章就让我们用最原始的方式来使用ActiveX,不使用任何MFC,ATL等框架,也不使用编译器提供的#import之类的指令,也不使用任何ide提供的向导。

像OLE、ActiveX等COM的术语,即便是微软也说不清它们的关系,所以下面说的我也这样模棱两可下去,只要明白意思即可。

首先,要了解一下的是ActiveX技术是为了做“嵌入”这样的功能而诞生的,比如:在Word中插入一张Bitmap图片,双击此图片,Word会调用画笔程序的功能来编辑图片,整个Word的菜单栏也会变成画笔程序的菜单栏。所以,ActiveX控件相当的复杂,有着几十个相关的接口。简单的说来,ActiveX控件的父窗口被称为“容器”,所以作为ActiveX控件的使用者来说,要实现的接口基本上都是IOleXXXXContainer或IOleXXXXSite之类的;而ActiveX则实现了IOleXXXXObject等接口。在这些接口中,大多有“InPlace”这个术语,指的是“InPlace edit”,也就是Word通过双击图片调用画笔编辑图片就称为“InPlace edit”(仅仅了解一下,和这篇文章说的使用AcitveX控件无关)。

在这样一篇文章中,我并不想讲很多COM或者AcitveX的知识,只是讲使用ActiveX所必须涉及的接口,然后你就可以去查MSDN中的其他一些可选的接口来一步步对这个ActiveX加强控制。

作为一个最简单的程序,我们需要实现的接口有:IOleClientSite和IOleInPlaceSite。使用到的AcitveX提供的接口有:IOleObject和IOleInPlaceObject。创建ActiveX控件的步骤:

  1. 创建一个类,实现IOleClientSite和IOleInPlaceSite。
  2. 使用CoCreateInstance创建相应ActiveX控件的实例,并获取它的IOleObject接口指针。
  3. 调用IOleObject::SetClientSite传入第一步中的类的指针。
  4. 调用IOleObject::DoVerb完成ActiveX控件的创建。
  5. 之后,可以调用ActiveX控件的IOleInPlaceObject::SetObjectRects调整控件的大小和位置。

根据以上步骤,创建如下函数:

HRESULT CreateAxControl(HWND hWnd,const wchar_t * ProgId,IUnknown ** ppControlUnknown,IUnknown ** ppContainerUnknown);

第一个参数hWnd是父窗口句柄。ProgId是ActiveX控件的ProgId,因为我们不使用编译器的#import,一般不知道所要创建控件的CLSID。ppControlUnknown是用来返回ActiveX控件的IUnknown指针。ppContainerUnknown是用来返回用来代表父窗口的IUnknown指针。

代码如下(这里的代码去除了出错的处理):

复制代码
HRESULT CreateAxControl(HWND hWnd,const wchar_t * ProgId,IUnknown ** ppControlUnknown,IUnknown ** ppContainerUnknown){    HRESULT hr;    CLSID cls;    IOleObject * pObject = NULL;    CControlContainer * pContainer = NULL;        //通过ProgId得到CLSID    CLSIDFromProgID(ProgId,&cls);        //创建ActiveX控件的对象,顺便得到IOleObject指针    CoCreateInstance(cls,NULL,CLSCTX_INPROC_SERVER|CLSCTX_INPROC_HANDLER|CLSCTX_LOCAL_SERVER,        IID_IOleObject,(void**)&pObject);        //CControlContainer是实现了IOleClientSite和IOleInPlaceSite接口的类    pContainer = new CControlContainer(hWnd);        //调用IOleObject::SetClientSite,传入容器指针    pObject->SetClientSite(pContainer);        //调用IOleObject::DoVerb,显示控件    pObject->DoVerb(OLEIVERB_SHOW,0,pContainer,0,hWnd,0);        //一些返回的参数    pObject->QueryInterface(IID_IUnknown,(void**)ppControlUnknown);    pContainer->QueryInterface(IID_IUnknown,(void**)ppContainerUnknown);    if (pObject) pObject->Release();    if (pContainer) pContainer->Release();    return S_OK;}
复制代码

CControlContainer类的实现非常简单,基本上IOleClientSite和IOleInPlaceSite接口大部分的方法都只要简单的返回S_OK或E_NOTIMPLE即可。唯一需要实现的是IUnknown的方法,还有IOleWindow接口(IOleInPlaceSite继承于IOleWindow)的GetWindow(返回父窗口的句柄)。代码如下:

复制代码
class CControlContainer:public IOleClientSite,public IOleInPlaceSite{    HWND m_hWnd;    ULONG m_refCnt;public:    CControlContainer(HWND hWnd)    {        m_hWnd = hWnd;        m_refCnt = 1;    }    ~CControlContainer()    {    }    .... IUnknown的实现    //IOleControlSite    STDMETHOD(SaveObject())    {        return E_NOTIMPL;    }    STDMETHOD(GetMoniker(DWORD,DWORD,IMoniker**))    {        return E_NOTIMPL;    }    STDMETHOD(GetContainer(IOleContainer **ppContainer))    {        return E_NOINTERFACE;    }    STDMETHOD(ShowObject())    {        return S_OK;    }    STDMETHOD(OnShowWindow(BOOL bShow))    {        return S_OK;    }    STDMETHOD(RequestNewObjectLayout())    {        return E_NOTIMPL;    }    //IOleWindow    STDMETHOD(GetWindow(HWND * pHwnd))    {        *pHwnd = m_hWnd;        return S_OK;    }    STDMETHOD(ContextSensitiveHelp(BOOL bEnterMode))    {        return S_OK;    }    //IOleInPlaceSite    STDMETHOD(CanInPlaceActivate())    {        return S_OK;    }    STDMETHOD(OnInPlaceActivate())    {        return S_OK;    }    STDMETHOD(OnUIActivate())    {        return S_OK;    }    STDMETHOD(GetWindowContext(/* [out] */ IOleInPlaceFrame **ppFrame,        /* [out] */ IOleInPlaceUIWindow **ppDoc,        /* [out] */ LPRECT lprcPosRect,        /* [out] */ LPRECT lprcClipRect,        /* [out][in] */ LPOLEINPLACEFRAMEINFO lpFrameInfo))    {        return E_NOTIMPL;    }    STDMETHOD(Scroll(SIZE scrollSize))    {        return S_OK;    }    STDMETHOD(OnUIDeactivate(BOOL bUndoable))    {        return S_OK;    }    STDMETHOD(OnInPlaceDeactivate())    {        return S_OK;    }    STDMETHOD(DiscardUndoState())    {        return S_OK;    }    STDMETHOD(DeactivateAndUndo())    {        return S_OK;    }    STDMETHOD(OnPosRectChange(LPCRECT lprcPosRect))    {        return S_OK;    }};
复制代码

接下来,在父窗口的窗口过程中,调用上面实现的函数,创建一个Flash控件:

复制代码
IUnknown * g_pControl = NULL;//控件的指针LRESULT CALLBACK WndProc(HWND hWnd, UINT message, WPARAM wParam, LPARAM lParam){    ....    switch(message)    {    case WM_CREATE:        //Flash控件        hr = CreateAxControl(hWnd,L"ShockwaveFlash.ShockwaveFlash",&pControl,&pContainer);        if (SUCCESSED(hr))        {            VARIANT src;            src.vt = VT_BSTR;            src.bstrVal = SysAllocString(L"http://www.google.com/intl/en_ALL/images/logo.gif");            DispSetProperty(pControl,L"movie",&src);//这个函数的实现,请下载源代码        }        break;    case WM_SIZE:        {               //调整控件的大小                        RECT rcClient;            GetClientRect(hWnd,&rcClient);            IOleInPlaceObject * pInPlaceObject;            if (g_pControl &&                 SUCCEEDED(g_pControl->QueryInterface(IID_IOleInPlaceObject,(void**)&pInPlaceObject)))            {                pInPlaceObject->SetObjectRects(&rcClient,&rcClient);                pInPlaceObject->Release();            }        }        break;    }    ....}
复制代码

下载源代码

在下一篇,可能会写如何响应ActiveX的Dispatch事件。