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.

Prerequisite: Adding a Multi-select list control.

1. On the Presentation tab of the Properties panel, specify the Edit options for the Multi-Select list control. These selections take precedence over section and harness settings:
   • Auto – The list is editable for an application end user, depending on the edit mode of the enclosing section or harness.
   • Read-only (always) – The property values for the list are read-only for the user and you cannot change the size of the control.
   • Read-only (expression) – Select this setting and in the adjacent field press the Down Arrow key to select the expression used to evaluate the conditions in which the list's property values are read-only.
   • Read-only (when rule) – Select this setting and in the adjacent field press the Down Arrow key to select the when rule that determines the conditions in which the list's property values are read-only.
   • Editable – The list is editable for a user.
2. Set the Specify size option:
   • Auto – Select this setting to have the layout determine the width of the control.
   • Custom – Select this setting to specify a fixed width for the list in the corresponding Width field. You can set the list's width in pixels or as a percentage.
3. Use the Label format field to set the format of the control's label.
4. Optional: Specify advanced presentation options.

   Instead of creating a new custom format in the skin, you can adjust elements in a cell by applying Cascading Style Sheet (CSS) helper classes. For example, you can use a CSS helper class to center an element in a cell or to double the standard right margin for the element.

   • Cell read-write classes – Click the Open helper class picker icon to specify one or more CSS helper classes to apply to this cell when the form is displayed in read-write mode. You can enter several helper classes, separated by a space. Alternatively, you can enter the name of a custom style to apply to this cell.
   • Cell read-only classes – Click the Open helper class picker icon to specify one or more CSS helper classes to apply to this cell when the form is displayed in read-only mode. You can enter several helper classes, separated by a space. Alternatively, you can enter the name of a custom style to apply to this cell.
   • Inline style (not for production use) – You can use this field to define an inline style by entering CSS code. However, entering an inline style results in a guardrail warning. For maintainability and reuse, the recommended approach is to use read-write or read-only classes.
   For more information, see CSShelper classes.
5. Click Submit. You can now Specify actions for a control.

• 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.

• 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.

• 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.

• Copying, moving, or deleting a control

  You can use basic Windows operations to speed the development of your controls.