17.3.2.5 caps

This element specifies that any lowercase characters in this text run shall be formatted for display only as their capital letter character equivalents. This property does not affect any non-alphabetic character in this run, and does not change the Unicode character for lowercase text, only the method in which it is displayed.

This formatting property is a toggle property (17.7.3).

If this element is not present, the default value is to leave the formatting applied at previous level in the style hierarchy. If this element is never applied in the style hierarchy, then the characters are not formatted as capital letters.

This element shall not be present with the smallCaps (17.3.2.33) property on the same run, since they are mutually exclusive in terms of appearance.

[Example: Consider the words Hello, world, which must be displayed in all capital letters in a document. This constraint is specified as follows in the WordprocessingML:

<w:r>
  <w:rPr>
    <w:caps w:val="true" />
  </w:rPr>
  <w:t>Hello, world</w:t>
</w:r>

This run displays as HELLO, WORLD, even though the lowercase characters are used in the run contents due to the use of the caps element. If this property is removed, the original character forms is displayed (they are not lost). end example]

This element’s content model is defined by the common boolean property definition in 17.17.4.