Overview
This is a field which can be used for a single choice, or multiple choices from a list. The value property determines what selected option value will be populated in the field when the program gets the screen input. When the program outputs to the screen, it attempts to match what is in the 'value' field to an option in the select box. If no match is present the first options is selected. The list of choices can be loaded in a variety of ways, please see below for more detail.
Validation (Rich UI Only)
Please visit the Validation and Error Messages page.
Field Binding Dialog (Rich UI Only)
Please visit the Field Binding page.
Select Box Properties
select box height - This property is used to convert the select box to a List Box and displays the choices in a selectable list instead of the dropdown box.
multiple - This specifies that multiple values can be selected from the select box. The default value of the property is 'false'. If set to 'true' the select box will convert to a List Box.
Choices / Choice Values Properties
These properties can be used to set the list of options in the select box:
...
- Comma separated list - A simple list of values separated by just a comma (i.e. Option 1, Option 2, Option 3, etc...).
- JSON array format - Using JSON array format, meaning the choices/values are enclosed in a bracket with quotations and then comma separated (i.e. ["ElementOne", "ElementTwo", "ElementThree"] ) within the choices and choice values fields also allows you to populate the auto-complete.
Database-Driven Selection
This section allows choices/choice values to be retrieved from a database file.
...
Max Choices
The max choices property allows you to set the number of choices you will see from your database-driven selection. There is no limit to the number of choices you can show, however if there is no limit set the default is 10.
Dynamic Auto-Complete
Choices URL
The choices URL property allows you to use an external program to return your choice options and values by passing them using JSON formatting. A PHP script would be one example of a custom program used to pass the values to your application. When using the choices URL property, all database-driven auto-complete properties are ignored.
...