presentation Element

Applies To: Windows Server 2008

The presentation element corresponds to the parameters for a single Group Policy setting displayed in the Group Policy Object Editor.

Syntax

The syntax of the presentation element declaration is:

    <presentation id="<placeholder for logical or friendly name>">
      <text> … </text>
      <decimalTextBox> … </decimalTextBox>
      <textBox> … </textBox>
      <checkBox> … </checkBox>
      <comboBox> … </comboBox>
      <dropdownList> … </dropdownList>
      <listBox> … </listBox>
    </presentation>

Attributes

Attributes Required Description

id Attribute

Yes

Specifies a logical name when referencing the presentation information for a specific policy setting.

Child elements

Element Required Description

text Element (presentation)

Yes

A localized string. Used for defining text located above and below the parameter input.

decimalTextBox Element

No

Represents a text box with or without a spin control for entering decimal numbers as a policy setting parameter. Must be associated with a decimal element defined in the elements element.

textBox Element

No

Represents a text box parameter. Must be associated with a text element defined in the elements element.

checkBox Element

No

Represents a check box parameter. Must be associated with a boolean element defined in the elements element.

comboBox Element

No

Represents a combo box parameter with default or suggested entries. Must be associated with a text element as defined in the elements element.

dropdownList Element

No

Represents a drop-down list parameter with which a user can pick one of the displayed entries. Must be associated with an enum element defined in the elements element.

listBox Element

No

Represents a list box parameter with Add and Remove buttons. This is the only parameter that can be used to manage multiple values under one key. Must be associated with a list element defined in the elements element.

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 child elements specified in the presentation element must correspond to those defined in the elements element of the .admx file. The Group Policy Object Editor will display an error if there is not a matching presentation child element for an existing elements child element.

Examples

This XML fragment is an example of a presentation element that contains the corresponding elements for a text box parameter declared through the elements element.

      <presentation id="Sample_Textbox">
        <textBox refId="Sample_TextboxPrompt">
          <label>Prompt label for textbox</label>
        </textBox>
      </presentation>

Additional references

presentationTable Element

elements Element