This control allows you to select one option from a group of two or more options. As with traditional radio buttons, you can group two or more of these controls; then, the user can select one of the options in the group.

A unique value is assigned to each radio button. The value assigned to the selected radio button control is saved 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 52 lists the layout properties for the Radio control and provides a brief description of each property.

Table 52. Radio 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.

Label

Use this property to configure the descriptive text associated with the radio button.

Width

Use this property to configure the width of the control.

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

Height

Use this property to configure the height of the control.

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

RadioGroup

Use this property to group two or more radio buttons. When radio buttons belong to the same group, only one of the radio buttons within a group can be selected.

If you need multiple groups of radio buttons, configure this property for each respective group of radio buttons.

Value

Use this property to configure the value stored in the task sequence variable when the radio button is selected.

 

Settings Properties

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

Table 53. Radio Control Settings Properties

Property

Description

Default value

Use this property to configure the default value for the control. By default, the value is set to the control ID.

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