Home Library Learn Downloads Support Community
Sign in | United States - English | |
2 out of 3 rated this helpful - Rate this topic

IWebBrowser2::HWND Property

Gets the handle of the Windows Internet Explorer main window.

Syntax

Copy 

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 Microsoft Internet Explorer 6.

Copy 

#include <shlguid.h>

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();
}
Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ
Bad type (not x64 compatible)
On x64 a HWND is 64bit so this property seems to have a bad type
History
Showing a modal dialog can use either the frame or the tab
See Modality, part 4: The importance of setting the correct owner for modal UI (http://blogs.msdn.com/oldnewthing/archive/2005/02/23/378866.aspx)
--
The cited article is irrelevant. The tab handle and the frame handle are equivalent for this purpose since one is a child of the other. -Raymond
History