comboBox Element
Applies To: Windows Server 2008
The comboBox element represents a combo box parameter. The comboBox element must be associated with a text element defined in the elements element.
Syntax
<comboBox refId="<placeholderID>" noSort ="true|false" >
<label> … </label>
<default> … </default>
<suggestion> … </suggestion>
</comboBox>
Attributes
Attributes | Required | Description |
---|---|---|
Yes |
A mapping to the element. |
|
No |
If true, display the suggested values in the defined order of the suggestion elements; otherwise, sort the suggested values in alphabetical order. If not specified, the noSort attribute will be set to false. |
Child elements
Element | Required | Description |
---|---|---|
Yes |
String label for the parameter. |
|
No |
A default string displayed in the combo box parameter. |
|
No |
A string listed in the drop-down list of the combo box parameter. |
Note
For simplicity of documentation, nested elements located one level down, known as child elements, will only be described for a given element.
Remarks
The comboBox element is associated with a combo box parameter in the Group Policy Management Console (GPMC) and the Local Group Policy Editor. The comboBox element will require a matching text element in the corresponding .admx file with matching id attribute as declared in the presentation element containing the comboBox element.
The label element, default element, and suggestion element must be defined in the order shown in the syntax section. If the order of the child elements of the comboBox element is not correctly specified, the GPMC and the Local Group Policy Editor will display an error message.
Examples
This XML fragment is an example of a comboBox element with default text displayed in the text box parameter when the policy setting is enabled. The noSort attribute is set to true which will cause the suggestion elements to be displayed in the same order as listed in the comboBox element.
<comboBox refId="Sample_ComboBox_Filename" noSort="true" >
<label>Sample Executable File Name</label>
<default>None</default>
<suggestion>Filename A</suggestion>
<suggestion>Filename B</suggestion>
<suggestion>EXECUTABLE.EXE</suggestion>
</comboBox>