WebBrowser介紹——Javascript與C 互操作

看見就非常 2012-09-17

展開全文

WebBrowser控件是Microsoft提供的一個用于網(wǎng)頁瀏覽的客戶端控件，WebBrowser控件的使用相當廣泛，例如很多郵件客戶端都是使用可編輯的WebBrowser控件作為寫郵件的工具，也有很多軟件用WebBrowser控件彈出網(wǎng)頁，如qq的個性首頁。關(guān)于WebBrowser的應用，也可以參考筆者開發(fā)的開源WebIM，Lesktop開源WebIM提供的IM客戶端就是使用WebBrowser實現(xiàn)的：

微軟的MFC和.NET都有WebBrowser控件，這兩個控件雖然容易上手，不過由于包裝的太好，所以很難深入。因此本文介紹的WebBrowser將不使用MFC和.NET，而是使用C++實現(xiàn)SDK的WebBrowser。

由于本文主要探討如何實現(xiàn)Javascript與C++的互操作，對于如何使用SDK實現(xiàn)WebBrowser，本文不做詳細介紹，讀者可以參考以下這篇文章：

http://blog.csdn.net/norsd/archive/2008/09/13/2921389.aspx

不過盡管文章中介紹了SDK實現(xiàn)WebBrowser的要點，卻沒有提供一個可以運行的示例，如果要看到實際的運行效果，可以下載以下這份源代碼，源代碼中也包括了互操作的演示：

SDK實現(xiàn)WebBrowser及演示代碼 [好文，推薦一下看不懂]

1、C++調(diào)用WebBrowser中的全局函數(shù)，變量等

(1) 從C++的角度看WebBrowser中的對象

WebBrowser中的對象大致可以分成兩類：DOM對象和使用Javascript創(chuàng)建的對象。但是無論是那種對象，從C++的角度來看，都是一些實現(xiàn)了IDispatch接口的對象，因此，如果用C++操作WebBrowser中的對象（全局函數(shù)，變量，DOM）等，只需要通過IDispatch即可。

(2) 3個常用的函數(shù)

當獲取了WebBrowser的對象的IDispatch接口后，就可以調(diào)用IDispatch的Invoke方法來調(diào)用對象的方法，獲取對象的屬性和設置對象的屬性。但是Invoke是通過ID判斷要調(diào)用指定對象的哪一個方法（或?qū)傩裕?，因此在通過方法（或?qū)傩裕┟Q調(diào)用對象的方法是，必須先調(diào)用IDispatch的GetIDsOfNames方法，將方法（或?qū)傩裕┟D(zhuǎn)換成ID，然后才能通過IDispatch的Invoke方法調(diào)用對象的方法。為了方便操作，封裝了三個函數(shù)，分別用于調(diào)用WebBrowser的對象的方法，讀取對象的屬性，設置對象的屬性。

DISPID CWebBrowserBase::FindId(IDispatch *pObj, LPOLESTR pName)
{
    DISPID id = 0;
    if(FAILED(pObj->GetIDsOfNames(IID_NULL,&pName,1,LOCALE_SYSTEM_DEFAULT,&id))) id = -1;
    return id;
}

HRESULT CWebBrowserBase::InvokeMethod(IDispatch *pObj, LPOLESTR pName, VARIANT *pVarResult, VARIANT *p, int cArgs)
{
    DISPID dispid = FindId(pObj, pName);
    if(dispid == -1) return E_FAIL;

    DISPPARAMS ps;
    ps.cArgs = cArgs;
    ps.rgvarg = p;
    ps.cNamedArgs = 0;
    ps.rgdispidNamedArgs = NULL;

    return pObj->Invoke(dispid, IID_NULL, LOCALE_SYSTEM_DEFAULT, DISPATCH_METHOD, &ps, pVarResult, NULL, NULL);
}

HRESULT CWebBrowserBase::GetProperty(IDispatch *pObj, LPOLESTR pName, VARIANT *pValue)
{
    DISPID dispid = FindId(pObj, pName);
    if(dispid == -1) return E_FAIL;

    DISPPARAMS ps;
    ps.cArgs = 0;
    ps.rgvarg = NULL;
    ps.cNamedArgs = 0;
    ps.rgdispidNamedArgs = NULL;

    return pObj->Invoke(dispid, IID_NULL, LOCALE_SYSTEM_DEFAULT, DISPATCH_PROPERTYGET, &ps, pValue, NULL, NULL);
}

HRESULT CWebBrowserBase::SetProperty(IDispatch *pObj, LPOLESTR pName, VARIANT *pValue)
{
    DISPID dispid = FindId(pObj, pName);
    if(dispid == -1) return E_FAIL;

    DISPPARAMS ps;
    ps.cArgs = 1;
    ps.rgvarg = pValue;
    ps.cNamedArgs = 0;
    ps.rgdispidNamedArgs = NULL;

    return pObj->Invoke(dispid, IID_NULL, LOCALE_SYSTEM_DEFAULT, DISPATCH_PROPERTYPUT, &ps, NULL, NULL, NULL);
}

(3)調(diào)用頁面的全局函數(shù)

在網(wǎng)頁中，所有的全局函數(shù)均是window的一個方法，因此，如果要調(diào)用全局函數(shù)，首先要獲取到頁面的window對象，然后用InvokeMethod調(diào)用全局函數(shù)，例如，假設頁面中有一個Test全局函數(shù)：

<script language="javascript" type="text/javascript">
function Test()
{
    alert("你調(diào)用了Test");
}
</script>

那么，您可以在C++中用以下代碼調(diào)用Test函數(shù)：

VARIANT params[10];
VARIANT ret;
//獲取頁面window
IDispatch *pHtmlWindow = pBrowser->GetHtmlWindow();
//頁面全局函數(shù)Test實際上是window的Test方法，
CWebBrowserBase::InvokeMethod(pHtmlWindow, L"Test", &ret, params, 0);

(4)調(diào)用全局對象的方法

在網(wǎng)頁中，所有的全局變量均是window的一個屬性，因此，如果要調(diào)用變量的方法（或?qū)傩裕?，首先要獲取到頁面的window對象，然后用GetProperty獲取到全局變量，然后就可以調(diào)用這個對象的方法，或讀寫其屬性。例如，假設頁面中有一個globalObject全局變量：

<script language="javascript" type="text/javascript">
function GlobalObject()
{
    this.Test=function()
    {
        alert("你調(diào)用了GlobalObject.Test");
    }
}

var globalObject = new GlobalObject();
</script>

那么，您可以使用一下代碼調(diào)用globalObject的Test方法：

VARIANT params[10];
VARIANT ret;
//獲取頁面window
IDispatch *pHtmlWindow = pBrowser->GetHtmlWindow();
//獲取globalObject
CVariant globalObject;
params[0].vt = VT_BSTR;
params[0].bstrVal = L"globalObject";
CWebBrowserBase::GetProperty(pHtmlWindow, L"globalObject", &globalObject);
//調(diào)用globalObject.Test
CWebBrowserBase::InvokeMethod(globalObject.pdispVal, L"Test", &ret, params, 0);

2、在網(wǎng)頁中調(diào)用客戶端的方法

上文我們已經(jīng)介紹了如何在C++中調(diào)用WebBrowser中的對象，接下來，將介紹如何在頁面中調(diào)用客戶端中的函數(shù)和對象：

(1) 通過window.external調(diào)用

下面將示例如何通過window.external調(diào)用客戶端中的函數(shù),假設在C++中定義了一個名為CppCall的函數(shù)：

void CppCall()
{
    MessageBox(NULL, L"您調(diào)用了CppCall", L"提示(C++)", 0);
}

定義一個對象，并且實現(xiàn)IDispatch接口：

class ClientCall:public IDispatch
{
    long _refNum;
public:
    ClientCall()
    {
        _refNum = 1;
    }
    ~ClientCall(void)
    {
    }
public:

    // IUnknown Methods

    STDMETHODIMP QueryInterface(REFIID iid,void**ppvObject)
    {
        *ppvObject = NULL;
        if (iid == IID_IUnknown)    *ppvObject = this;
        else if (iid == IID_IDispatch)    *ppvObject = (IDispatch*)this;
        if(*ppvObject)
        {
            AddRef();
            return S_OK;
        }
        return E_NOINTERFACE;
    }

    STDMETHODIMP_(ULONG) AddRef()
    {
        return ::InterlockedIncrement(&_refNum);
    }

    STDMETHODIMP_(ULONG) Release()
    {
        ::InterlockedDecrement(&_refNum);
        if(_refNum == 0)
        {
            delete this;
        }
        return _refNum;
    }

    // IDispatch Methods

    HRESULT _stdcall GetTypeInfoCount(
        unsigned int * pctinfo) 
    {
        return E_NOTIMPL;
    }

    HRESULT _stdcall GetTypeInfo(
        unsigned int iTInfo,
        LCID lcid,
        ITypeInfo FAR* FAR* ppTInfo) 
    {
        return E_NOTIMPL;
    }

    HRESULT _stdcall GetIDsOfNames(
        REFIID riid, 
        OLECHAR FAR* FAR* rgszNames, 
        unsigned int cNames, 
        LCID lcid, 
        DISPID FAR* rgDispId 
    )
    {
        if(lstrcmp(rgszNames[0], L"CppCall")==0)
        {
            //網(wǎng)頁調(diào)用window.external.CppCall時，會調(diào)用這個方法獲取CppCall的ID
            *rgDispId = 100;
        }
        return S_OK;
    }

    HRESULT _stdcall Invoke(
        DISPID dispIdMember,
        REFIID riid,
        LCID lcid,
        WORD wFlags,
        DISPPARAMS* pDispParams,
        VARIANT* pVarResult,
        EXCEPINFO* pExcepInfo,
        unsigned int* puArgErr
    )
    {
        if(dispIdMember == 100)
        {
            //網(wǎng)頁調(diào)用CppCall時，或根據(jù)獲取到的ID調(diào)用Invoke方法
            CppCall();
        }
        return S_OK;
    }
};

定義類ClientCall后，就可以創(chuàng)建一個ClientCall的對象，傳遞給WebBrowser，使得網(wǎng)頁中可以通過window.external調(diào)用CppCall，要實現(xiàn)這些功能，WebBrowser需要實現(xiàn)IDocHostUIHandler接口，并重寫GetExternal方法以返回一個ClientCall對象：

ClientCall *pClientCall;
pClientCall = new ClientCall();

virtual HRESULT STDMETHODCALLTYPE GetExternal(IDispatch **ppDispatch)
{
    //重寫GetExternal返回一個ClientCall對象
    *ppDispatch = pClientCall;
    return S_OK;
}

接下來，就可以在網(wǎng)頁中調(diào)用了：

window.external.CppCall()

(2)向網(wǎng)頁傳遞回調(diào)函數(shù)

向網(wǎng)頁傳遞回調(diào)函數(shù)的一個典型應用就是在客戶端中用C++處理DOM的事件(例如，處理按鈕的onclick事件)，這里要注意的是，與C++不同的是，在網(wǎng)頁中，所謂的函數(shù)，其實就是一個具有call方法的對象，因此，向網(wǎng)頁傳遞一個回調(diào)函數(shù)，其實就是傳遞一個實現(xiàn)了call方法的對象，因此，我們必須定義一個C++類，并實現(xiàn)IDispatch接口：

typedef void _stdcall JsFunction_Callback(LPVOID pParam);

class JsFunction:public IDispatch
{
    long _refNum;
    JsFunction_Callback *m_pCallback;
    LPVOID m_pParam;
public:
    JsFunction(JsFunction_Callback *pCallback, LPVOID pParam)
    {
        _refNum = 1;
        m_pCallback = pCallback;
        m_pParam = pParam;
    }
    ~JsFunction(void)
    {
    }
public:

    // IUnknown Methods

    STDMETHODIMP QueryInterface(REFIID iid,void**ppvObject)
    {
        *ppvObject = NULL;

        if (iid == IID_IOleClientSite)    *ppvObject = (IOleClientSite*)this;
        else if (iid == IID_IUnknown)    *ppvObject = this;
        if(*ppvObject)
        {
            AddRef();
            return S_OK;
        }
        return E_NOINTERFACE;
    }

    STDMETHODIMP_(ULONG) AddRef()
    {
        return ::InterlockedIncrement(&_refNum);
    }

    STDMETHODIMP_(ULONG) Release()
    {
        ::InterlockedDecrement(&_refNum);
        if(_refNum == 0)
        {
            delete this;
        }
        return _refNum;
    }

    // IDispatch Methods

    HRESULT _stdcall GetTypeInfoCount(
        unsigned int * pctinfo) 
    {
        return E_NOTIMPL;
    }

    HRESULT _stdcall GetTypeInfo(
        unsigned int iTInfo,
        LCID lcid,
        ITypeInfo FAR* FAR* ppTInfo) 
    {
        return E_NOTIMPL;
    }

    HRESULT _stdcall GetIDsOfNames(
        REFIID riid, 
        OLECHAR FAR* FAR* rgszNames, 
        unsigned int cNames, 
        LCID lcid, 
        DISPID FAR* rgDispId 
    )
    {
        //令人費解的是，網(wǎng)頁調(diào)用函數(shù)的call方法時，沒有調(diào)用GetIDsOfNames獲取call的ID，而是直接調(diào)用Invoke
        return E_NOTIMPL;
    }

    HRESULT _stdcall Invoke(
        DISPID dispIdMember,
        REFIID riid,
        LCID lcid,
        WORD wFlags,
        DISPPARAMS* pDispParams,
        VARIANT* pVarResult,
        EXCEPINFO* pExcepInfo,
        unsigned int* puArgErr
    )
    {
        m_pCallback(m_pParam);
        return S_OK;
    }
};

接下來，我們就可以使用JsFunction向網(wǎng)頁傳遞回調(diào)，以下代碼用于處理按鈕的onclick事件：

static void _stdcall button1_onclick(LPVOID pParam)
{
    MainForm *pMainForm = (MainForm*)pParam;
    MessageBox(pMainForm->hWnd, L"您點擊了button1", L"提示(C++)", 0);
}

VARIANT params[10];

//獲取window
IDispatch *pHtmlWindow = GetHtmlWindow();

//獲取document
CVariant document;
params[0].vt = VT_BSTR;
params[0].bstrVal = L"document";
GetProperty(pHtmlWindow, L"document", &document);

//獲取button1
CVariant button1;
params[0].vt = VT_BSTR;
params[0].bstrVal = L"button1";
InvokeMethod(document.pdispVal, L"getElementById", &button1, params, 1);

//處理button1的onclick事件
params[0].vt = VT_DISPATCH;
params[0].pdispVal = new JsFunction(button1_onclick, this);
SetProperty(button1.pdispVal, L"onclick", params);