Properties of a Dropdown list control

Use the following tabs to configure the properties of a Dropdown list control.

General

Name

Description

Type

The type of the control.

Name

A unique name for the dropdown list.

Tooltip

The supplementary information that displays by hovering the mouse over the dropdown list at runtime.

For example, "use this form to enter your professional details."

State

The state of the control. Available options are: Optional and Mandatory and Hidden. (Default: Optional)

Enabled

Enables the control at runtime.

Read only

If selected, makes the control read-only.

A read-only control shows the progress/design of a job/process, respectively, with key information.
A non-read-only control allows the active user to interact with the control and change properties, provided they have appropriate permissions.

Security token

Makes the form secure. See Security tokens.

Hint text

Additional information that guides the user.

Error message

An error message that is displayed on performing a wrong operation.

Select on focus

If selected, provides focus to the item on mouse-click, or by pressing the Tab or Arrow keys.

Option display mode

Define whether to display Text, or both Text and value when you expand the dropdown list at runtime.

If you select the Text and value option, the text and value are displayed in separate columns. The default Text width % is 75% and Value width %is 25%. You can change the width in percentage as needed.

Selection display mode: This property is only available on selecting the Text and value option. It lets you define whether to display text or both text and value upon selecting an item from the dropdown list at runtime.

When you use static data to define the display options to and set one as the default, the value appears according to the configured display mode.
When a form has an action, such as the Same page action to set the selected item, the value appears according to the configured display mode.
When a Dropdown list control is used in an action, the value is used regardless of the display mode.

At runtime, you can also enter the search text, so that the matching row appears as the first row.

Search filtering

Use either option to define how the items should be filtered on search at runtime:

Starts with match: Displays all the items that begin with the entered letter or string. (Default)
Contains match: Displays all the items that contain the entered letter or string.

The following table shows examples of the both search filters.

Search option	List of items	Searched letter or string	Filtered items
Starts with match	var1 maxval var2 RootValueSet valueSet	"v"	var1 var2 valueSet
Contains match	obj1 inputVal My obj Preval maxobj	"ob"	obj1 My obj maxObjVal