temporary (Remove Structured Document Tag When Contents Are Edited)

This element specifies whether the parent structured document tag shall be removed from the WordprocessingML document when the its contents are modified.

[Note: This setting is primarily intended for creating structured document tags whose sole purpose is one-time placeholder text, and which should not return once replaced with content. end note]

If this element is omitted, then the parent structured document tag shall not be automatically removed when its contents are modified.

[Example: Consider the following plain text structured document tag:

<w:sdt>
<w:sdtPr>
<w:temporary/>
<w:text/>
</w:sdtPr>
…
</w:sdt>

This plain text structured document tag's properties contain a temporary element, specifying that the structured document tag itself shall be deleted from the document whenever its contents are first modified. end example]

Parent Elements

sdtPr (§2.5.2.37)

Attributes

Description

val (On/Off Value)

Specifies a binary value for the property defined by the parent XML element.

A value of on, 1, or true specifies that the property shall be explicitly applied. This is the default value for this attribute, and is implied when the parent element is present, but this attribute is omitted.

A value of off, 0, or false specifies that the property shall be explicitly turned off.

[Example: For example, consider the following on/off property:

<w:… w:val="off"/>

The val attribute explicitly declares that the property is turned off. end example]

The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67).

The following XML Schema fragment defines the contents of this element:

</complexType>