Share via


IWebBrowser2

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

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

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 home page
  • Accessing application executable file

Methods

The following table shows the Windows Mobile Standard methods supported for IWebBrowser2.

Methods Description

ClientToWindow

Converts client sizes into window sizes.

ExecWB

This method is not supported for Windows Mobile Version 5.0 and later versions.

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

get_Application

Retrieves 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

Retrieves an object reference to a container.

get_Document

Retrieves the automation object of the active document.

> [!NOTE] > It is currently not supported

get_FullName

Retrieves the file specification of the application, including the path.

get_Height

Retrieves the vertical dimension of the frame window, in pixels.

get_HWND

Retrieves the HWND of the current browser window.

get_Left

Retrieves the horizontal position of the frame window relative to the screen, in pixels.

get_LocationName

Retrieves the short, user-friendly name of the document currently being viewed.

get_LocationURL

Retrieves the full URL of the document currently being viewed.

get_Name

Retrieves the name of an application.

get_Offline

Retrieves a Boolean value that indicates whether an object is currently operating in offline mode.

get_Parent

Retrieves the parent of the object.

get_Path

Retrieves the path to the application.

get_ReadyState

Retrieves the ready state of an object.

get_StatusBar

Retrieves a Boolean value that indicates whether the status bar is visible or hidden.

get_Top

Retrieves 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

Retrieves the type name of the contained document object.

get_Visible

Retrieves a Boolean value that indicates whether an object is visible or hidden.

get_Width

Retrieves the horizontal dimension of the frame window, in pixels.

GetProperty

Retrieves the value of a property associated with an object.

GoBack

Browses to the previous item in the history list.

GoForward

Browses to the next item in the history list.

GoHome

Browses to the start page.

GoSearch

Browses to the search page.

Navigate

Browses to a URL or file.

Navigate2

Browses 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 in relation 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 in relation 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 Version 5.0 and later versions.

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 Windows Mobile Professional methods supported for IWebBrowser2.

Methods Description

ClientToWindow

Converts client sizes into window sizes.

ExecWB

This method is not supported for Windows Mobile Version 5.0 and later versions.

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

get_Application

Retrieves 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

Retrieves an object reference to a container.

get_Document

Retrieves the automation object of the active document.

get_FullName

Retrieves the file specification of the application, including the path.

get_Height

Retrieves the vertical dimension of the frame window, in pixels.

get_HWND

Retrieves the HWND of the current browser window.

get_Left

Retrieves the horizontal position of the frame window relative to the screen, in pixels.

get_LocationName

Retrieves the short, user-friendly name of the document currently being viewed.

get_LocationURL

Retrieves the full URL of the document currently being viewed.

get_Name

Retrieves the name of an application.

get_Offline

Retrieves a Boolean value that indicates whether an object is currently operating in offline mode.

get_Parent

Retrieves the parent of the object.

get_Path

Retrieves the path to the application.

get_ReadyState

Retrieves the ready state of an object.

get_StatusBar

Retrieves a Boolean value that indicates whether the status bar is visible or hidden.

get_Top

Retrieves 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

Retrieves the type name of the contained document object.

get_Visible

Retrieves a Boolean value that indicates whether an object is visible or hidden.

get_Width

Retrieves the horizontal dimension of the frame window, in pixels.

GetProperty

Retrieves the value of a property associated with an object.

GoBack

Browses to the previous item in the history list.

GoForward

Browses to the next item in the history list.

GoHome

Browses to the start page.

GoSearch

Browses to the search page.

Navigate

Browses to a URL or file.

Navigate2

Browses 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 in relation 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 in relation 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 Version 5.0 and later versions.

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 currently not 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

Header piedocvw.h
Library piedocvw.lib
Windows Embedded CE Windows Embedded CE 6.0 and later
Windows Mobile Pocket PC for Windows Mobile Version 5.0 and later, Smartphone for Windows Mobile Version 5.0 and later

See Also

Reference

Internet Explorer Mobile Browser Interfaces

Other Resources

Internet Explorer Mobile Browser Reference