Selecting the property for a Multi-select list control
Select a property for the control to determine the data type to include in the list that an application user sees. At run time, the user selects one or more values from the list.
Prerequisite: Adding a Multi-select list control.
- In the Property field on the General tab of the Properties panel, press the Down Arrow key and select a property, the value of which the user selects at run time.
-
Click the
Open
icon to review the property (if the reference is
to an existing property in the Applies To class of this rule or a parent of that class).
If the property is not found, the New dialog box is displayed and you can use it to create the property.
-
For the
Label
option, select one of two settings:
- To use the name of the property as the label for the control, select the Use property default check box.
- To specify a label for the control, clear the Use property default check box and enter the label in the adjacent, unlabeled field.
- Optional: To select an existing tooltip for the field or to enter a new one, press the Down Arrow key in the Tooltip field.
-
Set the
Visibility
option to determine when the property value is
displayed.
- Select Always, If not blank, or Not zero to display or hide the field based on the property value at the time this section or flow action is first presented or refreshed.
- Select Condition (expression) to make the visibility dependent on an expression. In the field that is displayed, select a condition or click the Open condition builder icon to open the Using the Condition Builder to configure dynamic UI actions..
- Select Condition (when rule) to make the visibility dependent on a when condition rule. Click the Open icon to create a when condition or review an existing one.
- Optional: To display a blank area in the section when the control is hidden, select the Reserve space when hidden check box.
-
To specify when the control is not available to end users, set the
Disable
option.
Specify a condition for disabling the text input:
- Never – Never disabled
- Always – Always disabled
- Condition (expression) – The text input is disabled under the specified condition. In the field that is displayed, select a condition or click the Open condition builder icon to open the Using the Condition Builder to configure dynamic UI actions.. You can define a simple expression based on the comparison of a pair of constants, properties, or both, combined by Boolean operators, such as .Color="Red". You can combine the expression with a when condition rule or another expression by using the && and || operators.
- Condition (when) – The text input is disabled under the specified condition. In the field that is displayed, select a when rule. Click the Open icon to create a when condition or review an existing when condition.
- Optional: To require application users to enter or select a value for this field to save the form, set the Required option.
- Optional: To display a text prompt with the control, select the Include placeholder check box. In the adjacent field, press the Down Arrow key to select preset text or click the Open icon to enter new text.
- Multi-select list controls
When constructing a user form, you can add a Multi-select list control to make it possible for the application's users to select more than one value for a single field. These lists save time and ensure accuracy by supplying a list of valid values for an input field.
- Adding and configuring a Multi-select list control
You add and configure a Multi-select list control when your application users need the ability to select multiple items for a single field.
- Specifying the list source for a Multi-select list control
Specify the data sourcedata page, clipboard page, or report definitionfor the Multi-select list control. At run time, the list is automatically refreshed with new items whenever the property value changes.
- Specifying presentation options for a Multi-select list control
In configuring how the Multi-select list control is displayed at run time, you specify whether the control is editable at run time, the width of the list control, and the label format for the control.
- Copying, moving, or deleting a control
You can use basic Windows operations to speed the development of your controls.
Previous topic Adding a Multi-select list control Next topic Specifying the list source for a Multi-select list control