Defining a Combo-Input Control 
Use
You use this procedure to define the properties, hyperlinks, and event handlers for a combo-input control. A combo-input control allows users to view or select data from a dropdown list at runtime. It also allows users to enter text in the field, if required. The dropdown list displays a list of valid choices. If a user enters invalid text, it is marked as such. The combo-input control can have more than one column in its dropdown list.
A combo-input control that shows a list of countries in two columns.
DE Germany
IN India
US United States
The combo-input control:
· Can be used in any type of tile
· Can be bound to the property of a data source or left unbound
· Can be associated with a hyperlink
Prerequisites
You have:
· Added a combo-input control in a tile
· Identified the property of the data source that you want to associate with the combo-input control
Ensure that you have associated a combo engine for this property.
· Identified the business anchor that references the data source of the required property
· Switched to the required change list
Procedure
...
1. In the Solution Explorer, locate the tile for which you want to design the combo-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 combo-input control.
3. Enter the appropriate values for the combo-input control properties.
For information on each of the properties, see Properties of a Combo-Input Control.
4. If you do not need to create a hyperlink, 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. 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 |
beforeListDataFetched |
The user chooses the combo button. This event occurs before the combo control retrieves the list from the combo engine. |
onBoundAttributeChanged |
The value of the combo-input field changes because the value of the BO attribute changed. |
onBtnClicked |
The user chooses the combo button or presses the Enter in the Combo field. If the combo control is unbound, this event can be used to fill the combo list. |
onSelected |
The user selects an item from the combo control. The event contains the selected item. The selected item can be changed by the event handler. |
onHyperlinkClicked |
The user chooses the hyperlink. This event occurs before the hyperlink is executed. |
onValueChanged2 |
The value of the combo field changed. |
The following table contains events that are not supported in this release. Choose the event in the Use event column for your code.
Unsupported event |
Use event |
onComboBtnClicked |
onBtnClicked |
onComboClosed |
onSelected |
onValueChanged |
onValueChanged2 |
c. Select Edit this handler code after creation and choose OK.
d. In the TODO area, enter the code you require for the event handler.
e. Save the code.
6. Save your entries.
Result
You have defined a combo-input control by specifying the properties, hyperlinks, and event handlers.
See also: