Step 5-14: Add Controls to New Custom Wizard Page

After the new UDI custom wizard page has been added to the New Computer stage group, the appropriate controls need to be added to the new custom wizard page. The controls are added to the custom wizard page from the Build Your Own Page toolbox, which is displayed when you view the custom wizard page on the Configure tab in the UDI Wizard Designer.

Table 38 lists the types of controls to your custom wizard page, which is illustrated in Figure 1.

Table 38. Types of Controls in the UDI Build Your Own Page Toolbox

Control type	Description
Checkbox	This control allows you to select or clear a configuration option and behaves as a traditional user interface (UI) check box. This control has a corresponding label that you can use to describe the purpose of the check box. The state of this control is True when the check box is selected and False when the check box is cleared. The state of the check box is stored in the task sequence variable configured for this control. For more information on this control, see Checkbox Control in the MDT document, Toolkit Reference.
Combobox	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. For more information on this control, see Combobox Control in the MDT document, Toolkit Reference.
Line	This control allows you to add a horizontal line to divide one portion of the custom wizard page from another. This control does not collect any configuration values but rather is used to visually enhance the UI. For more information on this control, see Line Control in the MDT document, Toolkit Reference.
Label	This control allows you to add descriptive, read-only text to the wizard page. This control does not collect any configuration values but rather is used to visually enhance the UI. For more information on this control, see Label Control in the MDT document, Toolkit Reference.
Radio	This control allows you to select one configuration option from a group of two or more options. As with traditional radio buttons, two or more of these controls can be grouped together, and then the user can select one of the options in the radio button group. A unique value is assigned to each option. The value assigned to the selected option control is saved in the task sequence variable configured for this control. For more information on this control, see Radio Control in the MDT document, Toolkit Reference.
Bitmap	This control allows you to add a bitmap graphic (.bmp file) to the custom wizard page. This control does not collect any configuration values but rather is used to visually enhance the UI. The path to the .bmp file is relative to the location of the UDI Wizard (OSDSetupWizard.exe). For more information on this control, see Bitmap Control in the MDT document, Toolkit Reference.
Textbox	This control allows you to enter text on the custom wizard page. The text typed into this control is saved in the task sequence variable configured for this control. For more information on this control, see Textbox Control in the MDT document, Toolkit Reference.

You can add any combination of these controls to your custom wizard page based on the information you want to collect. In addition, you can use the Show Gridlines check box to show or hide gridlines that can be used to assist in visually designing the custom wizard page.

For the purposes of this example, you will create a custom wizard page as illustrated in Figure 1.

Figure 1. Custom wizard page to be created

To add controls to the new custom wizard page

1. In the Page Library, click User Information page.

2. In the details pane, click the Configure tab.

The Build Your Own Page toolbox and empty wizard page are displayed.

3. In the Build Your Own Page toolbox, drag the Label control to the empty wizard page at approximately the following coordinates:

· x = 30

· y = 5

The label control is placed on the wizard page and named label1.

4. On the custom wizard page, click label1 (the label control added in step 3).

This control acts as a heading for the custom wizard page and describes the purpose of the page.

5. Configure the layout properties of label1 on the Layout tab using the information in Table 39. Accept the default values unless otherwise stated.

Table 39. label1 Layout Properties

Property	Value
Label	User and organization information
X	30
Y	5

6. In the Build Your Own Page toolbox, drag the Label control to the empty wizard page at approximately the following coordinates:

· x = 60

· y = 60

The label control is placed on the wizard page and named label2.

7. On the custom wizard page, click label2 (the control added in the previous step).

This control acts as a label for the text box used to enter the user name.

8. Configure the layout properties of label2 on the Layout tab using the information in Table 40. Accept the default values unless otherwise stated.

Table 40. lable2 Layout Properties

Property	Value
Label	User name
X	60
Y	60

9. In the Build Your Own Page toolbox, click and drag the Textbox control to the empty wizard page at approximately the following coordinates:

· x = 60

· y = 80

The Textbox control is placed on the wizard page and named text1.

10. On the custom wizard page, click text1 (the control added in the previous step).

This control is the text box used to enter the user name.

11. Configure the layout properties of text1 on the Layout tab using the information in Table 41. Accept the default values unless otherwise stated.

Table 41. text1 Layout Properties

Property	Value
X	60
Y	80
Width	400

12. Configure the settings properties of text1 on the Settings tab using the information in Table 42. Accept the default values unless otherwise stated.

Table 42. text1 Settings Properties

Property	Value
Task sequence variable name	FullName
Friendly display name visible in summary page	Registered user name

13. In the Build Your Own Page toolbox, drag the Label control to the empty wizard page at approximately the following coordinates:

· x = 60

· y = 60

The Label control is placed on the wizard page and named label3.

14. On the custom wizard page, click label3 (the control added in the previous step).

This control acts as a label for the combo box used to select the organization or department name for the user.

15. Configure the layout properties of lable3 on the Layout tab using the information in Table 43. Accept the default values unless otherwise stated.

Table 43. lable3 Layout Properties

Property	Value
Label	Organization or department name
X	60
Y	121

16. In the Build Your Own Page toolbox, drag the Combobox control to the empty wizard page at approximately the following coordinates:

· x = 60

· y = 140

The Combobox control is placed on the wizard page and named combo1.

17. On the custom wizard page, click combo1 (the control added in the previous step).

This control is the combo box used to select the organization name.

18. Configure the layout properties of combo1 on the Layout tab using the information in Table 44. Accept the default values unless otherwise stated.

Table 44. combo1 Layout Properties

Property	Value
X	60
Y	80
Width	400

19. Add data items to the layout properties of combo1 on the Layout tab using the information in Table 45. Accept the default values unless otherwise stated.

Table 45. combo1 Data Items

Value	Display Value
Woodgrove Bank – New York City	Woodgrove Bank – New York City
Woodgrove Bank – Dallas	Woodgrove Bank – Dallas
Woodgrove Bank – Chicago	Woodgrove Bank – Chicago
Woodgrove Bank – Seattle	Woodgrove Bank – Seattle

20. Configure the settings properties of combo1 on the Settings tab using the information in Table 46. Accept the default values unless otherwise stated.

Table 46. combo1 Settings Properties

Property	Value
Task sequence variable name	OrgName
Friendly display name visible in summary page	Registered organization name

21. On the Ribbon, on the Home tab, click Save.

The File Save dialog box appears.

22. In the File Save dialog box, click OK.

23. Close the UDI Wizard Designer.