!--a11y-->
Properties of a Choice-List
Control 
You need to specify the following properties for a choice-input control.
Two sets of properties are explained in this document. The first is for the Choice-List Control, and the second is for the Associated Popups to a Choice Control dialog box.
Choice Input Property |
Action |
|
Blankable |
Select True if the user can clear the control’s input field at runtime. Select False if the user cannot clear the control’s field at runtime.
The Input Field Editable property must be set to True. |
|
BO Attribute |
Enter the name of the property of a data source that you want to associate this control. |
|
Data Type |
Set the control’s data type.
The data type is derived from the BO attribute’s data type. |
|
Input Field Editable |
Select True if the user can edit the control’s input field at runtime. Select False if the user cannot edit the control’s field at runtime. |
|
Invoked Popup Window |
Specify the tile set displayed by choosing the choice-list control at runtime. |
|
IsGridColumn |
Select True if the choice-input control is a column within the grid control. Select False if the choice-input control is displayed outside the grid.
This property is displayed in tile of type Extended List. |
|
Label |
Enter a name for the label of the choice input field. For example, Last Name. |
|
Linked Popups |
Select the list of find/choice and custom popup tile sets that you want to appear in the selection box at runtime. For more information about the Linked Popups fields and options, see the Associate popups to a choice control table. |
|
Maximum Length |
Specify the maximum number of characters that can be entered or displayed in the choice-input field. |
|
Mode |
Set the mode for the control. |
|
If set to … |
Then … |
|
Normal
|
The control is active at runtime and the user can choose the associated popup tile set. |
|
Readonly |
The control is not active at runtime and the user can only read the data displayed in the choice- input field. |
|
Hidden |
The choice-input field is not displayed at runtime. |
|
Mandatory |
The user must select a value in the choice-input field at runtime. |
|
Name |
Enter a name with the assigned namespace. |
|
Offset |
Enter the width in pixels between the end of the label text and the choice-input field. |
|
Tab Order |
Enter a number to determine the order in which the control is selected using the Tab key at runtime. |
|
Target Attribute (required) |
Specify the primary key used to select the data record, based on the selection made in the popup window. The data type must be compatible with the primary key returned by the popup window. |
|
Top, Left, Bottom, Right |
Enter the coordinates based on the position of the control. The value you set for Top automatically determines the value for Bottom. |
|
Use Long Text |
Select True if you want the long text of the associated combo engine to display in the control’s input field. Select False if you want the Display Attribute or the BO Attribute text to display in the control’s input field. |
|
Associate Popups to a Choice Control
You need to specify the following properties for an associated popup tile set.
Field/Option Name |
Description |
Select custom popups |
Displays the list of find/choice and custom popup tile sets that you select to appear in the selection box at runtime. |
Details |
Displays the properties of the tile set currently selected in the list. |
Show selected |
Displays only the tile sets that you have selected. |
Alternative
key |
Displays the attributes of the popup window’s data source in a select list. Select the property required to identify the record to be returned to the choice-list control. |
Display Attribute |
Displays the attributes of a popup window’s data source in a selection list. The property you select displays in the choice-list input field to reflect the choice the user makes at runtime.
If no display attribute is assigned, the primary key of the record returned by the popup window determines BO attribute. |
Query Attribute |
Displays the attribute of the underlying Business Query. |
Default Invoked Popup Window |
Displays as selected for the tile set in the list that is used as the default tile set returned at runtime. You can change the selection. |
See also: