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
| Topic | Contents |
|---|---|
| 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
| Topic | Contents |
|---|---|
| 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
| Topic | Contents |
|---|---|
| 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
| Topic | Contents |
|---|---|
| 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
| Topic | Contents |
|---|---|
| RefreshConstants | Contains values used with the Refresh2 method. |
| SecureLockIconConstants | Contains values used by the SetSecureLockIcon event. |
Constants
| Topic | Contents |
|---|---|
| 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. |