Share via


IWebBrowser2

Send Feedback

The IWebBrowser2 interface enables applications to reuse the Internet Explorer Mobile web browser. This interface derives from the IWebBrowserApp interface, which in turn derives from the IWebBrowser interface.

Note   Windows Mobile-based Smartphones do not support frames.

The IWebBrowser2 interface supports features such as the following:

  • Displaying and modifying windows
  • Managing object states
  • Resizing objects
  • Managing the device
  • Managing the history list
  • Navigating to a URL, file, or start page
  • Accessing application executable file

Methods

The following table shows the Smartphone methods supported for IWebBrowser2.

Smartphone methods Description
ClientToWindow Converts client sizes into window sizes.
ExecWB This method is not supported for Windows Mobile Version 5.0.

Executes a command on an OLE object and returns the status of the command execution using the IOleCommandTarget::Exec method.

get_Application Gets the automation object for an application that is hosting the WebBrowser control.
get_Busy Indicates whether the object is engaged in a navigation or downloading operation.
get_Container Gets an object reference to a container.
get_Document Gets the automation object of the active document.
get_FullName Gets the file specification of the application, including the path.
get_Height Gets the vertical dimension of the frame window, in pixels.
get_HWND Gets the HWND of the current browser window.
get_Left Gets the horizontal position of the frame window relative to the screen, in pixels.
get_LocationName Gets the short, user-friendly name of the document currently being viewed.
get_LocationURL Gets the full URL of the document currently being viewed.
get_Name Gets the name of an application.
get_Offline Gets a Boolean value that indicates whether an object is currently operating in offline mode.
get_Parent Gets the parent of the object.
get_Path Gets the path to the application.
get_ReadyState Gets the ready state of an object.
get_StatusBar Gets a Boolean value that indicates whether the status bar is visible or hidden.
get_Top Gets the vertical position of the frame window relative to the screen, in pixels.
get_TopLevelContainer Indicates whether the object is a top-level container.
get_Type Gets the type name of the contained document object.
get_Visible Gets a Boolean value that indicates whether an object is visible or hidden.
get_Width Gets the horizontal dimension of the frame window, in pixels.
GetProperty Gets the value of a property associated with an object.
GoBack Navigates to the previous item in the history list.
GoForward Navigates to the next item in the history list.
GoHome Navigates to the start page.
GoSearch Navigates to the search page.
Navigate Navigates to a URL or file.
Navigate2 Navigates to a URL, file or item identifier list (pidl).
put_Height Sets the vertical dimension of the frame window, in pixels.
put_Left Sets the horizontal position of the frame window relative to the screen, in pixels.
put_Offline Sets a Boolean value that indicates whether an object is currently operating in offline mode.
put_StatusBar Sets a Boolean value that indicates whether the status bar is visible or hidden.
put_Top Sets the vertical position of the frame window relative to the screen, in pixels.
put_Visible Sets a Boolean value that indicates whether an object is visible or hidden.
put_Width Sets the horizontal dimension of the frame window, in pixels.
PutProperty Sets the value of a property associated with an object.
QueryStatusWB This method is not supported for Windows Mobile 5.0.

Queries the OLE object for the status of commands using the IOleCommandTarget::QueryStatus method.

Quit Exits an application and closes the open document.
Refresh Refreshes the currently viewed page.
Refresh2 Refreshes the currently viewed page.
Stop Stops opening a file.

The following table shows the Pocket PC methods supported for IWebBrowser2.

Pocket PC methods Description
ClientToWindow Converts client sizes into window sizes.
ExecWB This method is not supported for Windows Mobile 5.0.

Executes a command on an OLE object and returns the status of the command execution using the IOleCommandTarget::Exec method.

get_AddressBar (PPC) Gets a Boolean value that indicates whether the address bar is visible or hidden.
get_Application Gets the automation object for an application that is hosting the WebBrowser control.
get_Busy Indicates whether the object is engaged in a navigation or downloading operation.
get_Container Gets an object reference to a container.
get_Document Gets the automation object of the active document.
get_FullName Gets the file specification of the application, including the path.
get_Height Gets the vertical dimension of the frame window, in pixels.
get_HWND Gets the HWND of the current browser window.
get_Left Gets the horizontal position of the frame window relative to the screen, in pixels.
get_LocationName Gets the short, user-friendly name of the document currently being viewed.
get_LocationURL Gets the full URL of the document currently being viewed.
get_Name Gets the name of an application.
get_Offline Gets a Boolean value that indicates whether an object is currently operating in offline mode.
get_Parent Gets the parent of the object.
get_Path Gets the path to the application.
get_ReadyState Gets the ready state of an object.
get_StatusBar Gets a Boolean value that indicates whether the status bar is visible or hidden.
get_Top Gets the vertical position of the frame window relative to the screen, in pixels.
get_TopLevelContainer Indicates whether the object is a top-level container.
get_Type Gets the type name of the contained document object.
get_Visible Gets a Boolean value that indicates whether an object is visible or hidden.
get_Width Gets the horizontal dimension of the frame window, in pixels.
GetProperty Gets the value of a property associated with an object.
GoBack Navigates to the previous item in the history list.
GoForward Navigates to the next item in the history list.
GoHome Navigates to the start page.
GoSearch Navigates to the search page.
Navigate Navigates to a URL or file.
Navigate2 Navigates to a URL, file or item identifier list (pidl).
put_AddressBar (PPC) Sets a Boolean value that indicates whether the address bar is visible or hidden.
put_Height Sets the vertical dimension of the frame window, in pixels.
put_Left Sets the horizontal position of the frame window relative to the screen, in pixels.
put_Offline Sets a Boolean value that indicates whether an object is currently operating in offline mode.
put_StatusBar Sets a Boolean value that indicates whether the status bar is visible or hidden.
put_Top Sets the vertical position of the frame window relative to the screen, in pixels.
put_Visible Sets a Boolean value that indicates whether an object is visible or hidden.
put_Width Sets the horizontal dimension of the frame window, in pixels.
PutProperty Sets the value of a property associated with an object.
QueryStatusWB This method is not supported for Windows Mobile 5.0.

Queries the OLE object for the status of commands using the IOleCommandTarget::QueryStatus method.

Quit Exits an application and closes the open document.
Refresh Refreshes the currently viewed page.
Refresh2 Refreshes the currently viewed page.
Stop Stops opening a file.

Remarks

The following members are not currently implemented. They return the E_NOTIMPL value.

  • get_FullScreen
  • get_MenuBar
  • get_RegisterAsBrowser
  • get_RegisterAsDropTarget
  • get_Resizable
  • get_Silent
  • get_StatusText
  • get_TheaterMode
  • get_ToolBar
  • put_FullScreen
  • put_MenuBar
  • put_RegisterAsBrowser
  • put_RegisterAsDropTarget
  • put_Resizable
  • put_Silent
  • put_StatusText
  • put_TheaterMode
  • put_ToolBar
  • ShowBrowserBar

Requirements

Pocket PC: Windows Mobile Version 5.0 and later
Smartphone: Windows Mobile Version 5.0 and later
OS Versions: Windows CE 5.01 and later
Header: piedocvw.h
Library: piedocvw.lib

See Also

Internet Explorer Mobile Browser Reference | Internet Explorer Mobile Browser Interfaces

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.