Reference for Visual Basic Developers

This section contains a reference guide for using the WebBrowser control with Microsoft Visual Basic. This reference covers all the supported properties, methods, and events associated with the WebBrowser and InternetExplorer objects.

Objects

InternetExplorer

Controls an instance of Windows Internet Explorer through automation.

WebBrowser

Adds browsing capabilities to your applications. For the Microsoft .NET Framework version of this control, see WebBrowser Control (Windows Forms).

Properties

AddressBar

Sets or gets a value that indicates whether the address bar of the object is visible or hidden.

Application

Gets the automation object for the application that is hosting the WebBrowser Control.

Busy

Gets a value that indicates whether the object is engaged in a navigation or downloading operation.

Container

Gets an object reference to a container.

Document

Gets the automation object of the active document, if any.

FullName

Retrieves the fully qualified path of the Internet Explorer executable.

FullScreen

Sets or gets a value that indicates whether Internet Explorer is in full-screen mode or normal window mode.

Height

Sets or gets the height of the object.

HWND

Gets the handle of the Internet Explorer main window.

Left

Sets or gets the coordinate of the left edge of the object.

LocationName

Retrieves the path or title of the resource that is currently displayed.

LocationURL

Gets the URL of the resource that is currently displayed.

MenuBar

Sets or gets a value that indicates whether the Internet Explorer menu bar is visible.

Name

Retrieves the frame name or application name of the object.

Offline

Sets or gets a value that indicates whether the object is operating in offline mode.

Parent

Gets the parent of the object.

Path

Retrieves the system folder of the Internet Explorer executable.

ReadyState

Gets the ready state of the object.

RegisterAsBrowser

Sets or gets a value that indicates whether the object is registered as a top-level browser window.

RegisterAsDropTarget

Sets or gets a value that indicates whether the object is registered as a drop target for navigation.

Resizable

Sets or gets a value that indicates whether the object can be resized.

Silent

Sets or gets a value that indicates whether the object can display dialog boxes.

StatusBar

Sets or gets a value that indicates whether the status bar for the object is visible.

StatusText

Sets or gets the text in the status bar for the object.

TheaterMode

Sets or gets whether the object is in theater mode.

ToolBar

Sets or gets whether toolbars for the object are visible.

Top

Sets or gets the coordinate of the top edge of the object.

TopLevelContainer

Gets a value that indicates whether the object is a top-level container.

Type

Gets the user type name of the contained document object.

Visible

Sets or gets a value that indicates whether the object is visible or hidden.

Width

Sets or gets the width of the object.

Methods

ClientToWindow

Computes the full size of the browser window when given the specified width and height of the content area.

ExecWB

Executes a command and returns the status of the command execution using the IOleCommandTarget interface.

GetProperty

Gets the value associated with a user-defined property name.

GoBack

Navigates backward one item in the history list.

GoForward

Navigates forward one item in the history list.

GoHome

Navigates to the current home or start page.

GoSearch

Navigates to the current search page.

Navigate

Navigates to a resource identified by a URL or to a file identified by a full path.

Navigate2

Navigates the browser to a location that might not be expressed as a URL, such as a pointer to an item identifier list (PIDL) for an entity in the Windows Shell namespace.

PutProperty

Associates a user-defined name/value pair with the object.

QueryStatusWB

Queries the object for the status of commands using the IOleCommandTarget interface.

Quit

Closes the object.

Refresh

Reloads the file that is currently displayed in the object.

Refresh2

Reloads the file that is currently displayed with the specified refresh level.

ShowBrowserBar

Shows or hides a specified browser bar.

Stop

Cancels a pending navigation or download, and stops dynamic page elements, such as background sounds and animations.

Events

BeforeNavigate

Fires before navigation occurs in the given object (on either a window or frameset element).

BeforeNavigate2

Fires before navigation occurs in the given object (on either a window element or a frameset element).

ClientToHostWindow

Fires to request that the client window size is converted to the host window size.

CommandStateChange

Fires when the enabled state of a command changes.

DocumentComplete

Fires when a document is completely loaded and initialized.

DownloadBegin

Fires when a navigation operation begins.

DownloadComplete

Fires when a navigation operation finishes, is halted, or fails.

FileDownload

Fires to indicate that a file download is about to occur. If a file download dialog box can be displayed, this event fires prior to the appearance of the dialog box.

NavigateComplete

Fires after a navigation to a link is completed on either a window element or a frameSet element.

NavigateComplete2

Fires after a navigation to a link is completed on a window element or a frameSet element.

NavigateError

Fires when an error occurs during navigation.

NewProcess

Creates a new process to handle the navigation.

NewWindow

Fires when a new window is to be created.

NewWindow2

Fires when a new window is to be created.

NewWindow3

Raised when a new window is to be created. Extends NewWindow2 with additional information about the new window.

OnFullScreen

Fires when the FullScreen property is changed.

OnMenuBar

Fires when the MenuBar property is changed.

OnQuit

Fires before the Internet Explorer application quits.

OnStatusBar

Fires when the StatusBar property is changed.

OnTheaterMode

Fires when the TheaterMode property is changed.

OnToolBar

Fires when the ToolBar property is changed.

OnVisible

Fires when the Visible property of the object is changed.

PrintTemplateInstantiation

Fires when a print template is instantiated.

PrintTemplateTeardown

Fires when a print template is destroyed.

PrivacyImpactedStateChange

Fired when an event occurs that impacts privacy, or when a user navigates away from a URL that has impacted privacy.

ProgressChange

Fires when the progress of a download operation is updated on the object.

PropertyChange

Fires when the PutProperty method of the object changes the value of a property.

RedirectXDomainBlocked

Fired when a cross-domain redirect request is blocked.

SetPhishingFilterStatus

Fires to indicate the progress and status of Microsoft Phishing Filter analysis of the current webpage.

SetSecureLockIcon

Fires when there is a change in encryption level.

StatusTextChange

Fires when the status bar text of the object has changed.

ThirdPartyUrlBlocked

Fired when a third-party URL is blocked.

TitleChange

Fires when the title of a document in the object becomes available or changes.

UpdatePageStatus

Not implemented.

WindowActivate

Not implemented.

WindowClosing

Fires when the window of the object is about to be closed by script.

WindowMove

Not implemented.

WindowResize

Not implemented.

WindowSetHeight

Fires when the object changes its height.

WindowSetLeft

Fires when the object changes its left position.

WindowSetResizable

Fires to indicate whether the host window should allow resizing of the object.

WindowSetTop

Fires when the object changes its top position.

WindowSetWidth

Fires when the object changes its width.

WindowStateChanged

Fires when the visibility state of a content window, such as the browser window or a tab, changes.

Enumerations

RefreshConstants

Contains values used with the Refresh2 method.

SecureLockIconConstants

Contains values used by the SetSecureLockIcon event.

Constants

NavigateError Event Status Codes

This page lists the possible values for the StatusCode parameter of the NavigateError event handler. These navigation-related error values are extracted from two documents: HTTP Status Codes and URL Moniker Error Codes. Follow the link for the status code you are interested in for a description of its meaning.