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 |
|---|---|---|
Yes |
A mapping to the element. |
Child elements
| Element | Required | Description |
|---|---|---|
Yes |
String label for the text box parameter. |
|
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>