Defining a Browser Control  

Use

You use this procedure to define the properties and event handlers for a browser control. The browser control is used to display the contents of any URL (Uniform Resource Location) or any Microsoft Office file on the mobile client application.

Inside the browser control, you can display the details of a Microsoft Word document, your company intranet, or internet web page.

A browser control:

·        Can be used in a Detail or Search tile

·        Cannot be associated with a hyperlink

·        Can be bound to a data source property or left unbound

·        Is read-only

A browser control can display the contents of the URL. It does not allow the user to modify the URL or to save the contents to the URL location.

Prerequisites

You have:

·        Added a browser control in a tile

·        Identified the property that you want to associate with this control and its data source. At runtime, this property specifies the URL that has to be displayed.

Ensure that you assigned String as the data type for this property.

·        Identified the business anchor that references this data source

·        Switched to the required change list

Procedure

...

       1.      In the Solution Explorer, locate the tile for which you want to design the Browser control, click the tile with the secondary mouse button, and choose View Designer.

The Tile Designer window appears.

       2.      Select the Browser control.

The Properties panel displays the values for the Browser control’s properties.

       3.      In the Properties panel, enter the appropriate values for the Browser Control properties.

For information on each of the properties, see Properties of a Browser Control.

       4.      If you do not need to create an event handler, continue with step 5. If you want to create an event handler, perform the following steps:

                            a.      In the Tile Designer, click the control with the secondary mouse button and choose Add Handler.

The New Event Handler dialog box appears with default values in the fields.

                            b.      In the Event field, select the event you want to use.

The following table provides information about the events.

Event Name	Description
onBoundAttributeChanged	The value of the Browser control changed. Either the user changed the value or the value of the associated BO attribute changed.
onDocumentComplete	The user closed the document or the URL page.
onValueChanged2	The value of the Browser field changed.

The onValueChanged event is not supported in this release. Use onValueChanged2 event.

                            c.      Select Edit this handler code after creation and choose OK.

                            d.      Enter the code you require for the event handler.

                            e.      Save the code.

3.       Save your entries.

Result

You have defined a browser control by specifying the properties and event handlers.

At runtime, the contents of the address specified by the property is displayed in the browser control.

See also:

 

Adding Controls to a Tile