Specify the data source—data page, clipboard page, or report definition—for the Multi-select list control. At run time, the list is automatically refreshed with new items whenever the property value changes.

Prerequisite: Adding a Multi-select list control.

1. In the Type field in the List Source section on the General tab of the Properties panel, specify the data source for the list:

   Data page

   1. Select this setting and in the corresponding Data page field, press the Down Arrow key to select the data page to use as the source of the list values.
   2. If the data page has parameters, you can pass parameter values to it. Press the Down Arrow key in the Value field to specify the value that you want to pass to the data page.

   Clipboard page

   1. Select this setting and in the corresponding Clipboard page field, press the Down Arrow key to select the clipboard page to use as the source of the list values.
   2. Determine whether the clipboard page is available at run time when the data is needed. For example, when the flow action or user form is displayed, is the work item present with appropriate data?

   Report definition

   1. Select this setting and in the corresponding Data page field, press the Down Arrow key to select the report definition to use as the source of the list values.
   2. In the Applies to field, specify the Applies To class of the report definition.
   3. Optional: If the report definition has parameters, press the Down Arrow key in the Value field to specify the value that you want to pass to the report definition.
2. In the Search results configuration section, specify the properties that are available for searching in the results set for the list.
   1. In the Data source property field, press the Down Arrow key to select the property from which the list is sourced.
   2. Select or clear the Show option to indicate whether the property is displayed in search results.
   3. Select or clear the Set value option and corresponding Property field to limit search results by value.
3. Optional: To set a limit for the number of results returned for the list, enter a number in the Maximum results to display field.
4. Optional: To specify the minimum number of characters that must be entered to create a list of possible matches for the list, enter a number in the Minimum characters to search field.
5. Optional: To highlight the search string in each place that it occurs in the results display, select the Highlight match check box.
6. Optional: To compare the search string only with the start of each string in the data—and not include in the results items where the string occurred in some other position—select the Match start of string check box.

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