17.5.2.12 docPartList

This element specifies that the nearest ancestor structured document tag shall be of a document part gallery type.

This setting does not require or imply that the contents of the structured document tag shall contain only the exact contents of a document part of the specified gallery and category which is present on the current machine, it shall only be used to specify that the structured document tag is of this kind, which shall be used by an application to present the possible list of choices for insertion into the nearest ancestor structured document tag.

[Example: Consider the following structured document tag:

<w:sdt>
  <w:sdtPr>
    …
    <w:docPartList>
      …
    </w:docPartList>
  </w:sdtPr>
  …
</w:sdt>

The docPartList element in this structured document tag’s properties specifies that the type of structured document tag is a document part gallery. The child elements must specify the gallery and category filters for this list, if any. end example]

[Note: The W3C XML Schema definition of this element’s content model (CT_SdtDocPart) is located in A.1. end note]