presentation Element

Article
07/02/2012

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

Share via