IWebBrowser2::HWND Property

[转]

 

IWebBrowser2::HWND Property

Gets the handle of the Microsoft Internet Explorer main window.

What's New for Windows Internet Explorer 7

For compatibility reasons, this method returns a handle to the top-level window frame, consistent with previous versions of Internet Explorer. However, due to tabbed browsing in Internet Explorer 7, this window handle is not logically the same as in previous versions.

Syntax

HRESULT IWebBrowser2::get_HWND(long *pHWND);

Parameters

pHWND

Pointer to a variable of type long that receives the window handle.

Return Value

Returns S_OK if successful, or an error value otherwise.

Remarks

Internet Explorer 7. With the introduction of tabbed browsing, the return value of this method can be ambiguous. To alleviate confusion and maintain the highest level of compatibility with existing applications, this method returns a handle to the top-level window frame, not the currently selected tab.

Example

For applications that absolutely require an HWND to the current tab, the following example returns the same logical window as IWebBrowser2::HWND in a previous version of Internet Explorer. This technique works equally well in both Internet Explorer 7 and Internet Explorer 6.

#include 

IServiceProvider* pServiceProvider = NULL;
if (SUCCEEDED(pWebBrowser2->QueryInterface(
                    IID_IServiceProvider, 
                    (void**)&pServiceProvider)))
{
    IOleWindow* pWindow = NULL;
    if (SUCCEEDED(pServiceProvider->QueryService(
                    SID_SShellBrowser, 
                    IID_IOleWindow,
                    (void**)&pWindow)))
    {
        HWND hwndBrowser = NULL;
        if (SUCCEEDED(pWindow->GetWindow(&hwndBrowser)))
        {
            // hwndBrowser is the handle of TabWindowClass
        }

        pWindow->Release();
    }
 
    pServiceProvider->Release();
}