[转载]裸写一个含内嵌IE控件的窗口

引言

之前也做过一些含内嵌IE控件的东西，只是一直用MFC/ATL等框架，对于里面的原理其实一知半解，只有脱离它们写一遍，才算能真正懂。前不久在写一个SkyDriveClient的时候正好有一个需求，就练习了一下。技术含量没有，在此记录一笔，供后来人入门，供前辈们批评。

本文中，行文以流水帐、贴代码方式为主，同时为了不带来干扰，代码将尽量以不带或少带封装的方式书写。目标明确，只为“功利性”地实现一个带IE控件的窗口。对于未实现的接口也不进行任何解释。

建立普通窗口

首先，我们建立一个普通的窗口程序。向导生成即可，剔除点代码，整理一下，代码清单如下：

#include<Windows.h>

#include<tchar.h>

LRESULTCALLBACK WndProc(HWNDhWnd, UINTmessage, WPARAMwParam, LPARAMlParam)

{

switch (message)

{

caseWM_DESTROY:

PostQuitMessage(0);

break;

default:

returnDefWindowProc(hWnd, message, wParam, lParam);

}

return 0;

}

intAPIENTRY_tWinMain(_In_HINSTANCE hInstance,

_In_opt_HINSTANCEhPrevInstance,

_In_LPTSTR lpCmdLine,

_In_int nCmdShow)

{

UNREFERENCED_PARAMETER(hPrevInstance);

UNREFERENCED_PARAMETER(lpCmdLine);

constLPCTSTR CLASS_NAME = _T("WebBrowserContainer");

WNDCLASSEX wcex = { sizeof(WNDCLASSEX) };

wcex.style = CS_HREDRAW | CS_VREDRAW;

wcex.lpfnWndProc = WndProc;

wcex.cbClsExtra = 0;

wcex.cbWndExtra = 0;

wcex.hInstance = hInstance;

wcex.hCursor = LoadCursor(nullptr, IDC_ARROW);

wcex.hbrBackground = (HBRUSH)(COLOR_WINDOW + 1);

wcex.lpszClassName = CLASS_NAME;

RegisterClassEx(&wcex);

HWND hWnd = CreateWindow(CLASS_NAME,

_T("WebBrowser Sample"),

WS_OVERLAPPEDWINDOW,

CW_USEDEFAULT,

nullptr,

hInstance,

nullptr);

if (hWnd == nullptr)

{

return 0;

}

ShowWindow(hWnd, nCmdShow);

UpdateWindow(hWnd);

MyWebBrowser wb(hWnd);

MSG msg = {};

while (GetMessage(&msg, nullptr, 0, 0))

{

if (!TranslateAccelerator(msg.hwnd, nullptr, &msg))

{

TranslateMessage(&msg);

DispatchMessage(&msg);

}

return (int)msg.wParam;

}

加入WebBrowser

这一部分主要参考了《使用C++实现SDK之WebBrowser容器》（http://blog.csdn.net/norsd/article/details/2921389）。但是这篇文章里没有给出真正可运行的代码，有几处小笔误，然后呢，其实我也不是很喜欢原作者的封装方式。本篇的目的是尽可能简单、原始，让后来者容易上手。

实现OLE容器类

实现一个WebBrowser，先要实现一个OLE容器类。我不知道OLE容器类的精确定义是什么，但现在我们需要实现三个接口：IOleClientSite、IOleInPlaceSite、IOleInPlaceFrame（<OleIdl.h>）。它们的定义在MSDN上都可以查到。

代码清单如下：

#pragmaonce

#include<Windows.h>

#include<OleIdl.h>

classOleContainer : publicIOleClientSite,

publicIOleInPlaceSite,

publicIOleInPlaceFrame

{

public:

OleContainer() : m_nRefCount(0),

m_pStorage(nullptr),

m_pOleObj(nullptr),

m_pInPlaceObj(nullptr),

m_hWindow(nullptr)

{

AddRef();

OleInitialize(nullptr);

}

~OleContainer()

{

if (m_pInPlaceObj != nullptr)

{

m_pInPlaceObj->Release();

m_pInPlaceObj = nullptr;

}

if (m_pOleObj != nullptr)

{

m_pOleObj->Release();

m_pOleObj = nullptr;

}

if (m_pStorage != nullptr)

{

m_pStorage->Release();

m_pStorage = nullptr;

}

OleUninitialize();

}

public:

bool CreateOleObject(constIID &clsid)

{

HRESULT hr = StgCreateDocfile(nullptr,

STGM_READWRITE | STGM_SHARE_EXCLUSIVE | STGM_DIRECT | STGM_CREATE,

&m_pStorage);

if (FAILED(hr))

{

returnfalse;

}

hr = OleCreate(clsid, IID_IOleObject, OLERENDER_DRAW, 0, this, m_pStorage, (LPVOID *)&m_pOleObj);

if (FAILED(hr))

{

returnfalse;

}

hr = m_pOleObj->QueryInterface(IID_IOleInPlaceObject, (LPVOID *)&m_pInPlaceObj);

if (FAILED(hr))

{

returnfalse;

}

returntrue;

}

bool InPlaceActive(HWNDhWnd, LPCRECTlpRect)

{

if (hWnd == nullptr)

{

returnfalse;

}

RECT rect = {};

if (lpRect == nullptr)

{

GetClientRect(hWnd, &rect);

lpRect = &rect;

}

HRESULT hr = m_pOleObj->DoVerb(OLEIVERB_INPLACEACTIVATE, nullptr, this, 0, hWnd, lpRect);

if (FAILED(hr))

{

returnfalse;

}

m_hWindow = hWnd;

returntrue;

}

public: // IUnknown Methods

HRESULTSTDMETHODCALLTYPE QueryInterface(REFIIDriid, LPVOID *ppvObject)

{

*ppvObject = nullptr;

if (riid == IID_IUnknown)

{

*ppvObject = (IOleClientSite *)this;

}

elseif (riid == IID_IOleInPlaceSite)

{

*ppvObject = (IOleInPlaceSite *)this;

}

elseif (riid == IID_IOleInPlaceUIWindow)

{

*ppvObject = (IOleInPlaceUIWindow *)this;

}

elseif (riid == IID_IOleInPlaceFrame)

{

*ppvObject = (IOleInPlaceFrame *)this;

}

if (*ppvObject == nullptr)

{

returnE_NOINTERFACE;

}

AddRef();

returnS_OK;

}

ULONGSTDMETHODCALLTYPE AddRef()

{

return (ULONG)InterlockedIncrement(&m_nRefCount);

}

ULONGSTDMETHODCALLTYPE Release()

{

LONG nRefCount = InterlockedDecrement(&m_nRefCount);

if (nRefCount <= 0)

{

deletethis;

}

return (ULONG)nRefCount;

}

public: // IOleClientSite Methods

STDMETHOD(SaveObject)()

{

returnE_NOTIMPL;

}

STDMETHOD(GetMoniker)(DWORDdwAssign, DWORDdwWhichMoniker, IMoniker **ppmk)

{

returnE_NOTIMPL;

}

STDMETHOD(GetContainer)(IOleContainer **ppContainer)

{

returnE_NOTIMPL;

}

STDMETHOD(ShowObject)()

{

returnE_NOTIMPL;

}

STDMETHOD(OnShowWindow)(BOOLfShow)

{

returnE_NOTIMPL;

}

STDMETHOD(RequestNewObjectLayout)()

{

returnE_NOTIMPL;

}

public: // IOleWindow Methods

STDMETHOD(GetWindow)(HWND *phwnd)

{

returnE_NOTIMPL;

}

STDMETHOD(ContextSensitiveHelp)(BOOLfEnterMode)

{

returnE_NOTIMPL;

}

public: // IOleInPlaceSite Methods

STDMETHOD(CanInPlaceActivate)()

{

return m_hWindow == nullptr ? S_OK : S_FALSE;

}

STDMETHOD(OnInPlaceActivate)()

{

returnE_NOTIMPL;

}

STDMETHOD(OnUIActivate)()

{

returnE_NOTIMPL;

}

STDMETHOD(GetWindowContext)(IOleInPlaceFrame **ppFrame,

IOleInPlaceUIWindow **ppDoc,

LPRECTlprcPosRect,

LPRECTlprcClipRect,

LPOLEINPLACEFRAMEINFOlpFrameInfo)

{

if (m_hWindow == nullptr)

{

returnE_NOTIMPL;

}

*ppFrame = (IOleInPlaceFrame*)this;

*ppDoc = NULL;

AddRef();

GetClientRect(m_hWindow, lprcPosRect);

GetClientRect(m_hWindow, lprcClipRect);

lpFrameInfo->cb = sizeof(OLEINPLACEFRAMEINFO);

lpFrameInfo->fMDIApp = false;

lpFrameInfo->hwndFrame = GetParent(m_hWindow);

lpFrameInfo->haccel = nullptr;

lpFrameInfo->cAccelEntries = 0;

returnS_OK;

}

STDMETHOD(Scroll)(SIZEscrollExtant)

{

returnE_NOTIMPL;

}

STDMETHOD(OnUIDeactivate)(BOOLfUndoable)

{

returnE_NOTIMPL;

}

STDMETHOD(OnInPlaceDeactivate)()

{

returnE_NOTIMPL;

}

STDMETHOD(DiscardUndoState)()

{

returnE_NOTIMPL;

}

STDMETHOD(DeactivateAndUndo)()

{

returnE_NOTIMPL;

}

STDMETHOD(OnPosRectChange)(LPCRECTlprcPosRect)

{

returnE_NOTIMPL;

}

public: // IOleInPlaceUIWindow Methods

STDMETHOD(GetBorder)(LPRECTlprectBorder)

{

returnE_NOTIMPL;

}

STDMETHOD(RequestBorderSpace)(LPCBORDERWIDTHSpborderwidths)

{

returnE_NOTIMPL;

}

STDMETHOD(SetBorderSpace)(LPCBORDERWIDTHSpborderwidths)

{

returnE_NOTIMPL;

}

STDMETHOD(SetActiveObject)(IOleInPlaceActiveObject *pActiveObject, LPCOLESTRpszObjName)

{

returnE_NOTIMPL;

}

public: // IOleInPlaceFrame Methods

STDMETHOD(InsertMenus)(HMENUhmenuShared, LPOLEMENUGROUPWIDTHSlpMenuWidths)

{

returnE_NOTIMPL;

}

STDMETHOD(SetMenu)(HMENUhmenuShared, HOLEMENUholemenu, HWNDhwndActiveObject)

{

returnE_NOTIMPL;

}

STDMETHOD(RemoveMenus)(HMENUhmenuShared)

{

returnE_NOTIMPL;

}

STDMETHOD(SetStatusText)(LPCOLESTRpszStatusText)

{

returnE_NOTIMPL;

}

STDMETHOD(EnableModeless)(BOOLfEnable)

{

returnE_NOTIMPL;

}

STDMETHOD(TranslateAccelerator)(LPMSGlpmsg, WORDwID)

{

returnE_NOTIMPL;

}

private:

LONG m_nRefCount;

protected:

IStorage *m_pStorage;

IOleObject *m_pOleObj;

IOleInPlaceObject *m_pInPlaceObj;

HWND m_hWindow;

};

这三个接口，连带他们的父类，总共需要实现31个方法！不过还好，除了篇幅稍微长一点，基本上都是E_NOTIMPL。

其中CreateOleObject和InPlaceActive是我自己加的，将来要调用的。

OleCreate期间，除了若干次QueryInterface之外，GetContainer会被调到一次。OLEIVERB_INPLACEACTIVATE期间，除了若干次QueryInterface之外，CanInPlaceActivate、OnInPlaceActivate、ShowObject会被调到。

那些不返回E_NOTIMPL的接口，我也没有一一查询是干嘛的，都是抄的~

实现WebBrowser容器类

上一节可视为（通用的）OLE容器类（只是没有使用除WebBrowser之外的其他玩意儿测试过，共性不是很明确，不敢保证通用性），这一节来实现WebBrowser。作为最简单的WebBrowser，不用再额外实现别的借口了，直接使用上面的OleContainer，创建WebBrowser对象即可。

代码清单：

#pragmaonce

#include"OleContainer.h"

#include<ExDisp.h>

classWebBrowser : publicOleContainer

{

public:

WebBrowser(HWNDhParent) : m_pWebBrowser(nullptr), m_hWnd(hParent)

{

}

~WebBrowser()

{

if (m_pWebBrowser != nullptr)

{

m_pWebBrowser->Release();

m_pWebBrowser = nullptr;

}

public:

bool CreateWebBrowser()

{

if (!CreateOleObject(CLSID_WebBrowser))

{

returnfalse;

}

RECT rect = {};

GetClientRect(m_hWnd, &rect);

if (!InPlaceActive(m_hWnd, &rect))

{

returnfalse;

}

HRESULT hr = m_pOleObj->QueryInterface(IID_IWebBrowser2, (LPVOID *)&m_pWebBrowser);

if (FAILED(hr))

{

returnfalse;

}

returntrue;

}

public:

void Navigate(LPCTSTRlpUrl)

{

BSTR bstrUrl = SysAllocString(lpUrl);

m_pWebBrowser->Navigate(bstrUrl, nullptr, nullptr, nullptr, nullptr);

SysFreeString(bstrUrl);

}

public:

STDMETHOD(GetWindow)(HWND *phwnd)

{

*phwnd = m_hWnd;

returnS_OK;

}

STDMETHOD(GetWindowContext)(IOleInPlaceFrame **ppFrame,

IOleInPlaceUIWindow **ppDoc,

LPRECTlprcPosRect,

LPRECTlprcClipRect,

LPOLEINPLACEFRAMEINFOlpFrameInfo)

{

*ppFrame = (IOleInPlaceFrame*)this;

*ppDoc = NULL;

AddRef();

GetClientRect(m_hWnd, lprcPosRect);

GetClientRect(m_hWnd, lprcClipRect);

lpFrameInfo->cb = sizeof(OLEINPLACEFRAMEINFO);

lpFrameInfo->fMDIApp = false;

lpFrameInfo->hwndFrame = GetParent(m_hWnd);

lpFrameInfo->haccel = nullptr;

lpFrameInfo->cAccelEntries = 0;

returnS_OK;

}

protected:

IWebBrowser2 *m_pWebBrowser;

HWND m_hWnd;

};

其中CreateWebBrowser 只是简单的调用了一下CreateOleObject，传入CLSID_WebBrowser。然后InPlaceActive就可以了。最后拿的m_pWebBrowser指针是备用的，用于实现一个示例功能：Navigate。

后面的GetWindow和GetWindowContext在OleContainer中已经有了，之所以再写一遍，是因为WebBrowser的创建过程中，就会调用GetWindow，需要给出一个窗口句柄；InPlaceActive过程中会调用GetWindowContext，也要做事情，不能return E_NOTIMPL了事。而OleContainer中，暂时我是在InPlaceActive的时候传入窗口句柄的。可能是OleContianer根本应该更早的知道窗口的存在，但这一点我还没弄清楚，所以暂时写成那样。但到WebBrowser层面，创建一个WebBrowser之前就需要先创建好窗口。

使用WebBrowser容器类

我们回到Main，创建好主窗口后插入几行代码：

intAPIENTRY_tWinMain(_In_HINSTANCE hInstance,

_In_opt_HINSTANCEhPrevInstance,

_In_LPTSTR lpCmdLine,

_In_int nCmdShow)

{

UNREFERENCED_PARAMETER(hPrevInstance);

UNREFERENCED_PARAMETER(lpCmdLine);

constLPCTSTR CLASS_NAME = _T("WebBrowserContainer");

WNDCLASSEX wcex = { sizeof(WNDCLASSEX) };

wcex.style = CS_HREDRAW | CS_VREDRAW;

wcex.lpfnWndProc = WndProc;

wcex.cbClsExtra = 0;

wcex.cbWndExtra = 0;

wcex.hInstance = hInstance;

wcex.hCursor = LoadCursor(nullptr, IDC_ARROW);

wcex.hbrBackground = (HBRUSH)(COLOR_WINDOW + 1);

wcex.lpszClassName = CLASS_NAME;

RegisterClassEx(&wcex);

HWND hWnd = CreateWindow(CLASS_NAME,

_T("WebBrowser Sample"),

WS_OVERLAPPEDWINDOW,

CW_USEDEFAULT,

nullptr,

hInstance,

nullptr);

if (hWnd == nullptr)

{

return 0;

}

ShowWindow(hWnd, nCmdShow);

UpdateWindow(hWnd);

MSG msg = {};

while (GetMessage(&msg, nullptr, 0, 0))

{

if (!TranslateAccelerator(msg.hwnd, nullptr, &msg))

{

TranslateMessage(&msg);

DispatchMessage(&msg);

}

return (int)msg.wParam;

}

然后运行，截图如下：

小结

上文演示了一个最简单的在正常窗口嵌入WebBrowser对象的例子。例子代码可在 http://pan.baidu.com/s/18PtQu（WebBrowserSample.rar）下载。

处于直观性考虑，没有做过多的封装和梳理。后面再来梳理这些。

posted @ 2016-03-11 15:30 Jingle Guo 阅读(804) 评论(0) 编辑收藏举报

经天纬地

Jingle Guo

[转载]裸写一个含内嵌IE控件的窗口

建立普通窗口

加入WebBrowser

实现OLE容器类

实现WebBrowser容器类

使用WebBrowser容器类

小结

公告