This element specifies the set of behaviors which shall be applied to the contents of the parent structured document tag when the contents of this documents are edited by an application (whether through a user interface or directly). The type of locking applied to the structured document tag is specified via the value of the associated val attribute.

If this element is omitted, then the locking settings implied for the structured document tag shall be as follows:

• If the structured document tag specifies that it is a group via the group element (§2.5.2.17), then the contents of the structured document tag shall be editable, but the entire tag may be deleted.

• For all other types, no locking settings shall be applied to the structured document tag.

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

<w:sdt>
<w:sdtPr>
<w:lock w:val="sdtLocked"/>
…
<w:text/>
</w:sdtPr>
…
</w:sdt>

This plain text structured document tag's properties contain a lock element, specifying locking behaviors for the structured document tag. Since the locking val attribute value is sdtLocked, this locking setting shall specify that the contents of the structured document tag may be edited, but the structured document tag itself shall not be deleted from the document. end example]

Parent Elements

sdtPr (§2.5.2.37)

Attributes

Description

val (Locking Type)

Specifies the type of locking which shall be applied to the parent structured document tag.

If this attribute is omitted, this its value shall be assumed to be unlocked (using the defaults stated above).

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

<w:sdtPr>
<w:lock w:val="contentLocked"/>
…
<w:text/>
</w:sdtPr>

The val attribute value is contentLocked, therefore this locking setting shall specify that the contents of the structured document tag shall not be edited, but the structured document tag itself may be deleted from the document. end example]

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

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

</complexType>