Defining a Multi-Line Input Control 

Use

You use this procedure to define the properties, hyperlinks, and event handlers for a multi-line input control. A multi-line input control is used to enter or display multiple lines of text on the mobile application. The label is part of the multi-line input control as shown below.

A multi-line input control:

·        Cannot be used as a column in a grid

·        Can be bound (associated with the property of a data source) or left unbound

·        Can be associated with a hyperlink

Prerequisites

You have:

·        Added a multi-line input control in a tile

·        Identified the property of the data source with which you want to associate the control, if the control is bound

Ensure that the data source property is assigned the Text data attribute type.

·        Identified the business anchor that references the data source to which the required property belongs

The business anchor name includes the name of the data source it references.

·        Switched to the required change list

Procedure

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

The Tile Designer window appears.

       2.      Select the control.

The Properties panel displays the values for the multi-line input control’s properties.

       3.      In the Properties panel, enter the appropriate values for the multi-line input control properties.

For information on each of the properties, see Properties of a Multi-Line Input Control.

       4.      If you do not need to create a hyperlink, continue with step 5. If you want to create a hyperlink, click the control with the secondary mouse button and choose View Hyperlinks.

For more information, see Model a Hyperlink.

       5.      If you do not need to create an event handler, continue with step 6. 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 BO property changes.
onHyperlinkClicked	The user chooses the hyperlink. This event occurs before the hyperlink is executed.
onValueChanged2	The value of the multi-line field changes.

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

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

                            d.      In the TODO section, enter the code you require for the event handler.

                            e.      Save the code.

       6.      Save the properties and event handlers by selecting the save icon in the toolbar.

Result

You have defined a multi-line input control by specifying the properties, hyperlinks, and event handlers.

At runtime, the user can enter unlimited information. When the information exceeds the available lines displayed, the vertical scrollbar appears.

See also:

 

Adding Controls to a Tile

Defining a Text-Input Control for a Tile

Defining a Static-Text Control for a Tile