<docPartCategory> (Document Part Category Filter)

This element specifies the category of document parts which shall be used as the filter when determining the possible choices of document parts which are displayed for insertion into the parent structured document tag. A document part category is a sub-classification within a given document part gallery which may be used to further categorize the parts in a given gallery.
example: : Gallery custom1 may have categories of Legal Clauses, Conformance Clauses, etc.
. The category which shall be used as a filter is stored in this element's @val attribute.

If this element is omitted, then the parent structured document tag shall display all document parts in the specified gallery regardless their specified category. If this element is present, but no document parts of the specified gallery and category combination are located by the application, then no document parts shall be displayed (i.e. the application shall not fall back to showing document parts in all categories in the specified gallery).

example: 
<w:sdtPr>
  <w:docPartList>
    <w:docPartGallery w:val="custom1"/>
    <w:docPartCategory w:val="Legal Clauses"/>
  </w:docPartList>
</w:sdtPr>

This structured document tag specifies that it shall present a selection of document parts for insertion via the <docPartList> element (§2.5.2.12) , and those document parts shall only be the parts which are in the custom1 gallery via the <docPartType> element (§2.5.2.11), and within that gallery, only the document parts which are in a category called Legal Clauses via this element. ]

Parent Elements

<docPartList> (§2.5.2.12); <docPartObj> (§2.5.2.13)

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>