[an error occurred while processing this directive]

This control allows you to select an item from a list of items and behaves as a traditional UI drop-down list. This control allows you to add or remove items from the list and provide a corresponding value that will be set in the task sequence variable configured for this control.

Layout Properties

Layout properties are used to configure the UI characteristics of the control and are configured on the Layout tab in the UDI Wizard Designer. Table 48 lists the layout properties for the Combobox control and provides a brief description of each property.

Table 48. Combobox Control Layout Properties

Property

Description

X

Use this property to configure the horizontal position of the control.

Y

Use this property to configure the vertical position of the control.

Width

Use this property to configure the width of the control.

Note   If the text entered in the control is longer than the width of the control, the text is not displayed.

Height

Use this property to configure the height of the control.

Note   If the text entered in the control is taller than the height of the control, the text is clipped.

Data Items

Use this property to configure the list of data items displayed in the control. Each data item has the following properties:

·     Value. The value stored in the task sequence variable when the data item is selected

·     DisplayValue. The value displayed to the user in the control

You can:

·     Add data items to the list using the blue plus sign button immediately to the right of the list of data items

·     Remove data items from the list using the red X button immediately to the right of the list of data items

Note   You cannot change the sequence of the data item in the list after an item is added to the list. Ensure that you enter the data items in the order you wish them to appear in the control.

 

Settings Properties

Settings properties are used to configure the data that is initially shown in a control (the default value) and where the information collected from the user is saved. Table 49 lists the settings properties for the Combobox control and provides a brief description of each property.

Table 49. Combobox Control Settings Properties

Property

Description

Task sequence variable name

Use this property to configure the task sequence variable where the information collected from the user is stored. If the task sequence variable:

·     Does not already exist, the task sequence variable is created and set to the value the user provides

·     Already exists, the existing value of the task sequence variable is overwritten with the value the user provides

Friendly display name visible in the summary page

Use this property to configure the descriptive name that appears on the Summary wizard page. This name is used to describe the value that was saved in the Task sequence variable name property for this control.

Unlocked

Use this property to configure whether the user is able to interact with the control. By default, the control is enabled. This button displays the following status:

·     Unlocked. The control is enabled, and users can enter information using it.

·     Locked. The control is disabled, and users are unable to enter information using it.

Note   If you disable (lock) a control, you must provide the information the control collected by configuring MDT properties in CustomSettings.ini or in the MDT DB. Otherwise, the UDI Wizard will not collect the necessary information, and the UDI deployment will fail.

 

Related Topics

UDI Build Your Own Page Toolbox Control Reference

[an error occurred while processing this directive]