Run (Character) Styles
Character styles are styles which apply to the contents of one or more runs of text within a document’s contents. This definition implies that the style can only define character properties (properties which apply to text within a paragraph) because it cannot be applied to paragraphs. Character styles can only be referenced by runs within a document, and they must be referenced by the <rStyle> element within a run’s run properties element.
A character style has two defining type-specific characteristics:
The
@typeattribute on the style has a value ofcharacter, which indicates that the following style definition is a character style.The style specifies only character-level properties using the
<rPr>element. In this case, the run properties are the set of properties applied to each run which is of this style.
The character style is then applied to runs by referencing the @styleId attribute value for this style in the run properties’ <rStyle> element.
<w:style w:type="character" w:styleId="TestCharacterStyle"> <w:name w:val="Test Character Style"/> <w:priority w:val="99"/> <w:qformat/> <w:rsid w:val="00E77BF0"/> <w:rPr> <w:rFonts w:ascii="Courier New" w:hAnsi="Courier New"/> <w:color w:val="FFF200"/> <w:u w:val="single"/> </w:rPr> </w:style>
Notice that the character properties applied using this style are under the <rPr> element. The document content for a paragraph with a run of this style would be:
<w:p>
<w:r>
<w:t xml:space="preserve">The following text is in the </w:t>
</w:r>
<w:r>
<w:rPr>
<w:rStyle w:val="TestCharacterStyle"/>
</w:rPr>
<w:t>character style</w:t>
</w:r>
<w:r>
<w:t>.</w:t>
</w:r>
</w:p>
The <rStyle> element in the second run links that run with the style definition, inheriting the formatting properties for that run. ]