Defining a Button-Input Control 

Use

You use this procedure to define the properties and event handlers for a button-input control. A button-input control displays selection data to the user in the mobile client application. You must write an event handler to specify the tile set to display as a dialog box when the user chooses the control.

A button-input control:

·        Cannot be associated to a grid control

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

·        Can be associated with a hyperlink

Prerequisites

You have:

·        Added a button-input control in a tile

·        Identified the property and its data source that you want to associate with this control. For example, the Lastname property of the Customer business object.

Ensure that you have assigned String as the data attribute 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 in which you want to add a button-input control, click the tile with the secondary mouse button and choose View Designer..

The Tile Designer window appears.

       2.      Open the Toolbox, drag the button-input control and drop it on the tile.

       3.      Select the button-input control and enter the appropriate values in the Properties panel.

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

       4.      If you do not want to add a hyperlink to the control, continue with step 5. If you want to associate a hyperlink with the text that appears in the control’s input field, click the control with the secondary mouse button and choose View Hyperlinks.

 For more information, see Model a Hyperlink.

       5.      Create an event handler.

                            a.      Click the event you want to add with the secondary mouse button and choose Add Handler.

The New Event Handler dialog box appears.

                            b.      In the Event field, choose the event you want to use. Use the following table to make your choice.

Event Name	Description
onBoundAttributeChanged	The value of the button-input field changes because the value of the associated BO attribute changed.
onBtnClicked	The user chooses the button and if the mode of the control is not read-only, then the value of forceClickEvent is True.
onHyperlinkClicked	The user chooses the hyperlink. The event occurs before the hyperlink is executed.
onValueChanged2	The value of the button changed.

The onValueChanged and the OnButtonInputClicked events are not supported in this release. Use onValueChanged2  and OnBtnClicked events.

                            c.      Select the Edit the handler code after creation field, and choose OK.

The code window opens.

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

       6.      Save your entries.

Result

You have defined a button-input control by specifying the properties and event handlers.

See also:

 

Adding Controls to a Tile