WebBrowser Control

This section contains reference information on WebBrowser Control.

Interfaces

IDocHostUIHandler (deprecated)

IDocHostUIHandler2

IWebBrowserApp (obsolete)

IWebBrowser (obsolete)

IWebBrowser2

DWebBrowserEvents (deprecated)

DWebBrowserEvents2

Enumerations

BrowserNavConstants

Contains values used by the IWebBrowser2::Navigate and IWebBrowser2::Navigate2 methods.

%navOpenInNewWindow = &H1
' Open the resource or file in a new window.
%navNoHistory = &H2
' Do not add the resource or file to the history list. The new page replaces the current page in the list.
%navNoReadFromCache = &H4
' Not currently supported.
%navNoWriteToCache = &H8
' Not currently supported.
%navAllowAutosearch = &H10
' If the navigation fails, the autosearch functionality attempts to navigate common root domains (.com, .edu, and so on). If this also fails, the URL is passed to a search engine.
%navBrowserBar = &H20
' Causes the current Explorer Bar to navigate to the given item, if possible.
%navHyperlink = &H40
' If the navigation fails when a hyperlink is being followed, this constant specifies that the resource should then be bound to the moniker using the BINDF_HYPERLINK flag.
 

CommandStateChangeConstants

Contains values used by the DWebBrowserEvents2::CommandStateChange event.

%CSC_UPDATECOMMANDS = &HFFFFFFFF
' Enabled state of a toolbar button might have changed.
%CSC_NAVIGATEFORWARD = &H00000001
' Enabled state of the Forward button has changed.
%CSC_NAVIGATEBACK = &H00000002
' Enabled state of the Back button has changed.
 

READYSTATE

Contains values that indicate what state an object is in.

%READYSTATE_UNINITIALIZED = 0
' Default initialization state.
%READYSTATE_LOADING = 1
' Object is currently loading its properties.
%READYSTATE_LOADED = 2
' Object has been initialized.
%READYSTATE_INTERACTIVE = 3
' Object is interactive, but not all of its data is available.
%READYSTATE_COMPLETE = 4
' Object has received all of its data.

Remarks

This is used with the ReadyState property and the IWebBrowser2::get_ReadyState method.
 

RefreshConstants

Contains values used with the Refresh2 and IWebBrowser2::Refresh2 methods.

%REFRESH_NORMAL = 0
' Refresh that does not include sending the HTTP "pragma:nocache" header to the server.
%REFRESH_IFEXPIRED = 1
' Refresh that occurs if the page has expired.
%REFRESH_CONTINUE = 2
' For internal use only; do not use.
%REFRESH_COMPLETELY = 3
' Refresh that includes sending a "pragma:nocache" header to the server (HTTP URLs only).

Remarks

The "pragma:nocache" header tells the server not to return a cached copy but to ensure that the information is as fresh as possible. Browsers typically send this header when the user selects Refresh, but the header can cause problems for some servers.
 

SecureLockIconConstants

Contains values used by the DWebBrowserEvents2::SetSecureLockIcon event.

%secureLockIconUnsecure = 0
' There is no security encryption present.
%secureLockIconMixed = &H1
' There are multiple security encryption methods present.
%secureLockIconUnknownBits = &H2
' The security encryption level is not known.
%secureLockIcon40Bit = &H3
' There is 40-bit security encryption present.
%secureLockIcon56Bit = &H4
' There is 56-bit security encryption present.
%secureLockIconFortezza = &H5
' There is Fortezza security encryption present.
%secureLockIcon128Bit = &H6
' There is 128-bit security encryption present.
 

Constants

NavigateError Event Status Codes

The following tables list the possible errors returned by the StatusCode parameter of the DWebBrowserEvents2::NavigateError event handler. For more information on HTTP status codes, see HTTP Status Codes.

HTTP Status Codes

HRESULT Status Codes