<docPart> (Document Part Reference)

This element specifies the name of the document part which shall be displayed in the parent structured document tag when its run contents are empty. If this element is specified, then a document part whose <name> element (§2.12.12) specifies a name matching the value of this element, and which belongs to the bbPlcHdr type shall be located to be used as the placeholder text for the parent structured document tag.

If no document part is located matching the criteria specified by this element, then five non-breaking spaces shall be used as the default placeholder text.

example: 
<w:sdt>
  <w:sdtPr>
    <w:placeholder>
      <w:docPart w:val="DefaultPlaceholder_22610170" /> 
    </w:placeholder>
    …
  </w:sdtPr>
  <w:sdtContent>
  …
  </w:sdtContent>
</w:sdt>

This structured document tag specifies through the <docPart> element that its placeholder text shall be specified in the document part of type bbPlcHdr whose @name is equal to DefaultPlaceholder_22610170. ]

Parent Elements

<placeholder> (§2.5.2.24)

Attributes

Description

<val> (String Value)

Specifies that its contents will contain a string.

The contents of this string are interpreted based on the context of the parent XML element.

<w:pPr>
  <w:pStyle w:val="heading1" /> 
</w:pPr>

The value of the @val attribute is the ID of the associated paragraph style's styleId.

However, consider the following fragment:

<w:sdtPr>
  <w:alias w:val="SDT Title Example" />
  ...
</w:sdtPr>

In this case, the decimal number in the @val attribute is the caption of the parent structured document tag. In each case, the value is interpreted in the context of the parent element. ]

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

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

<complexType name="CT_String">
	<attribute name="val" type="ST_String" use="required"/>
</complexType>