WebBrowser

Previous

---

The WebBrowser object provides the following methods and properties.

Methods

GoBack : Causes the browser to go back a page in the browsing order if possible.

GoForward  : Causes the browser to go forward a page in the browsing order if possible.

Navigate(URL As String) : Causes the browser to fetch the web page specified by URL from the Internet.

New1(form As Form, left As Int, Top As Int, width As Int, height As Int) : Creates a new WebBrowser of width and height at the top and left location on a form. Form is a string for a native Form or a  ControlRef for a FormEx.

Stop : Cancels any pending navigation and stops any dynamic page elements, such as background sounds and animations.

Properties

I signifies readable, O signifies settable.

CancelNavigate : Bool [O] : If set to True within the Navigating event will cancel the navigation to a new page. This property has no effect on a device running WM2203.

ControlRef : Control [I] : Gets a reference to the underlying WebBrowser control.

DocumentText : String [O] : Sets the html text for the browser to display. It is not possible to access the text of the browser whether set by DocumentText or by navigating to a URL. The Navigating, Navigated and DocumentComplete events occur after setting DocumentText.

DllVersion : Double [I] : Returns the version number of the library.

Height : Int [I/O] : Gets or sets the height of the form.

 

IsBusy : Bool [I] : True if the browser is busy

IsOffline : Bool [I] : True if the browser is not on line. This may cause a "NotSupportedException" error on the device

Left : Int [I/O] : Gets or sets the horizontal location of the control on the screen.

NavigatingURL  : String [I] : When accessed within or after a Navigating event returns the URL to which the page is navigating. This property returns "Unavailable on WM2003" on a device running WM2203.

Top : Int [I/O] : Gets or sets the vertical location of the control on the screen.

URL : String [I/O] : Sets or gets the URL of the current web page. Setting URL will cause the web page to be fetched from the Internet. 

Width : Int [I/O] : Gets or sets the width of the form.

Visible: bool [I/O] : Gets or sets whether the control is visible.

Events

DocumentCompleted : The browser has finished fetching and displaying the web page.

GotFocus : The control has been given the focus.

LostFocus : The control has lost the focus.

Navigating : The control is starting to navigate to a new web page. Except on devices running WM2003 the new web page URL may be accessed by the NavigatingURL property. Except on devices running WM2003 navigation may be canceled by setting the CancelNavigation property to True within the code for this event. The URL property is invalid during this event and may cause an exception  if accessed.

Navigated : Navigation to the new page is complete and and the browser is about to load and display the page.