Combo/List Box Data Tab    

Properties in the Combo/List Box Configuration Dialog Box: Data Tab 

Property

Description

Values

List Entry Type

Indicates whether the list/combo box will be populated directly by a data source, or will be populated by manually entered items.

Data Bound – Indicates that combo/list box items come from a data source that you specify. This option does not allow you to change the order the items will appear in.

Manual Entry – Allows you to manually enter list/combo box items. This option allows you to change the order the items will appear in.

Auto Sort

Indicates whether data is automatically sorted.

Selected – Data is sorted automatically.

Cleared – Data appears in the order you specify or in the same order as it appears in the original source.

Allow Multiple
Selections

NOTE: List box only.

Indicates whether the user will be able to select multiple values in the list box. This check box is not available for combo boxes.

Selected – The user can select multiple items in the list box.

Cleared – The user can select only single items in the list box.

Auto Select
First Entry

Indicates whether the first item in the list box is selected during run-time.

Selected – The first value returned by the data source is selected during run-time.

Cleared – No values are selected during run-time.

Data Source
to Display
(Data Bound
option)

Allows you to select the object's data source from the Data Source Browser. Data retrieved from the data source is displayed in the list/combo box.

Configure Data Source button – displays the Data Source Browser. See Data Source Browser Properties.

Configure Expression button – displays the Expression Builder. See Expression Builder Properties.

Advanced Settings button – displays the Advanced Settings dialog box. See Advanced Settings Properties.

Selected Item Column
(Data Bound
option)

Specifies what is passed when linked to another object via the Source Property "Selected Item".

List of columns returned by the data source.

Selected Value Column
(Data Bound
option)

Specifies what is passed when linked to another object via the Source Property "Selected Value". The selected value is used to `track' the selected item. For example, when linking a list of employee names to a grid, the selected item would be set as the employee name and the employee ID would be set as the selected value. The employee ID is the value that is passed to the grid, and the employee name appears in the Combo/List box.

List of columns returned by the data source.

Add Tags button (Manual Entry option)

NOTE: List box only.

Allows you to select a data source to populate the list box. You would use this option when you want the data source items to appear in the list box as strings. For example, if you want to be able to drag and drop data items from the list onto a grid or chart (so that the associated values are loaded into the grid or chart), you need to use this method.

See Data Source Browser Properties.

Add Strings button (Manual Entry option)

Allows you to enter Items and, optionally, Values to populate the combo/list box. For more information on using Items and Values, see

Opens the Item Value Editor dialog box.

Edit Selected Item button (Manual Entry option)

Allows you to make changes to either the manually entered items/values, or to the data source.

Opens either the Item Value Editor dialog box or the Data Source Browser dialog box, depending on what is selected in the table of Items/Values.

Delete Selected Item (Manual Entry option)

Allows you to delete the selected item.

N/A

Move Selected Item Up and Down buttons (Manual Entry option)

Allows you to move the selected item up or down in the list.

N/A