textBox Element

Applies To: Windows Server 2008

The textBox element represents a text box parameter. The textBox element must be associated with a text element defined in the elements element.

Syntax

     <textBox refId="<placeholderID>">
       <label> … </label>
       <defaultValue> … </defaultValue>
     </textBox>

Attributes

Attributes Required Description

refId Attribute

Yes

A mapping to the element.

Child elements

Element Required Description

label Element

Yes

String label for the text box parameter.

defaultValue Element

No

A default string displayed in the text 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 textBox element is associated with a text box parameter in the Group Policy Management Console (GPMC) or the Local Group Policy Editor. The textBox element will require a matching text element in the corresponding .admx file with matching id attribute as declared in the presentation element containing the textBox element.

If the label element is not defined as the first child element of the textBox element, the GPMC or the Local Group Policy Editor will display an error message.

Examples

This XML fragment is an example of a textBox element with default text displayed in the text box parameter when the policy setting is enabled.

        <textBox refId="Sample_textboxExpandszPrompt">
          <label>This text box allows input of environment variables:</label>
          <defaultValue>%SYSTEMROOT%\Example</defaultValue>
        </textBox>

Additional references

presentation Element

text Element