<rFonts> (Run Fonts)

This element specifies the fonts which shall be used to display the text contents of this run. Within a single run, there may be up to four types of content present which shall each be allowed to use a unique font:

  • ASCII

  • High ANSI

  • Complex Script

  • East Asian

The use of each of these fonts shall be determined by the Unicode character values of the run content, unless manually overridden via use of the <cs> element (§2.3.2.6).

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 text shall be displayed in any default font which supports each type of content.

example:

English العربية

This content may be expressed in a single WordprocessingML run:

<w:r>
  <w:t>English العربية</w:t>
</w:r>

Although it is in the same run, the contents are in different font faces by specifying a different font for ASCII and CS characters in the run:

<w:r>
  <w:rPr>
    <w:rFonts w:ascii="Courier New" w:cs="Times New Roman" />
  </w:rPr>
  <w:t>English العربية</w:t>
</w:r>

This text run shall therefore use the Courier New font for all characters in the ASCII range, and shall use the Times New Roman font for all characters in the Complex Script range. ]

Parent Elements

<rPr> (§2.7.8.1); <rPr> (§2.3.1.29); <rPr> (§2.5.2.26); <rPr> (§2.3.2.25); <rPr> (§2.3.2.26); <rPr> (§2.7.4.4); <rPr> (§2.3.1.30); <rPr> (§2.9.26); <rPr> (§2.5.2.27); <rPr> (§2.7.5.2)

Attributes

Description

<ascii> (ASCII Font)

Specifies a font which shall be used to format all characters in the ASCII range (0 - 127) within the parent run.

If the @asciiTheme attribute is also specified, then this attribute shall be ignored and that value shall be used instead.

If this attribute is not present, the default value is to leave the formatting applied at previous level in the style hierarchy. If this attribute is never applied in the style hierarchy, then the text shall be displayed in any default font which supports ASCII content. 

<w:rPr>
  <w:rFonts w:ascii=”Courier New” />
</w:rPr>

The @ascii attribute specifies that the run shall use the Courier New font for all text in the ASCII range. ]

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

<asciiTheme> (ASCII Theme Font)

Specifies a theme font which shall be used to format all characters in the ASCII range (0 - 127) within the parent run. This theme font is a reference to one of the predefined theme fonts, located in the document's Theme part,which allows for font information to be set centrally in the document.

If the @ascii attribute is also specified, then that attribute shall be ignored and this value shall be used instead.

If this attribute is not present, the default value is to leave the formatting applied at previous level in the style hierarchy. If this attribute is never applied in the style hierarchy, then the text shall be displayed in the font specified by the @ascii attribute. 

<w:rPr>
  <w:rFonts w:asciiTheme=”majorAscii” />
</w:rPr>

The @ascii attribute specifies that the run shall use the majorAscii theme font as defined in the document's themes part for all text in the ASCII range. ]

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

<cs> (Complex Script Font)

Specifies a font which shall be used to format all characters in a complex script Unicode range within the parent run.

If the @csTheme attribute is also specified, then this attribute shall be ignored and that value shall be used instead.

If this attribute is not present, the default value is to leave the formatting applied at previous level in the style hierarchy. If this attribute is never applied in the style hierarchy, then the text shall be displayed in any default font which supports complex script content. 

<w:rPr>
  <w:rFonts w:cs=”Arial Unicode MS” />
</w:rPr>

The @cs attribute specifies that the run shall use the Arial Unicode MS font for all text in a complex script range. ]

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

<cstheme> (Complex Script Theme Font)

Specifies a theme font which shall be used to format all characters in a complex script Unicode range within the parent run. This theme font is a reference to one of the predefined theme fonts, located in the document's Theme part,which allows for font information to be set centrally in the document.

If the @cs attribute is also specified, then that attribute shall be ignored and this value shall be used instead.

If this attribute is not present, the default value is to leave the formatting applied at previous level in the style hierarchy. If this attribute is never applied in the style hierarchy, then the text shall be displayed in the font specified by the @cs attribute.

<w:rPr>
  <w:rFonts w:csTheme=”majorBidi” />
</w:rPr>

The @csTheme attribute specifies that the run shall use the majorBidi theme font as defined in the document's themes part for all text in a complex script range. ]

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

<eastAsia> (East Asian Font)

Specifies a font which shall be used to format all characters in an East Asian Unicode range within the parent run.

If the @eastAsiaTheme attribute is also specified, then this attribute shall be ignored and that value shall be used instead.

If this attribute is not present, the default value is to leave the formatting applied at previous level in the style hierarchy. If this attribute is never applied in the style hierarchy, then the text shall be displayed in any default font which supports East Asian content. 

<w:rPr>
  <w:rFonts w:eastAsia=”MS Mincho” />
</w:rPr>

The @eastAsia attribute specifies that the run shall use the MS Mincho font for all text in an East Asian range. ]

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

<eastAsiaTheme> (East Asian Theme Font)

Specifies a theme font which shall be used to format all characters in an East Asian Unicode range within the parent run. This theme font is a reference to one of the predefined theme fonts, located in the document's Theme part,which allows for font information to be set centrally in the document.

If the @eastAsia attribute is also specified, then that attribute shall be ignored and this value shall be used instead.

If this attribute is not present, the default value is to leave the formatting applied at previous level in the style hierarchy. If this attribute is never applied in the style hierarchy, then the text shall be displayed in the font specified by the @eastAsia attribute.

<w:rPr>
  <w:rFonts w:eastAsiaTheme=”minorEastAsia” />
</w:rPr>

The @eastAsiaTheme attribute specifies that the run shall use the minorEastAsia theme font as defined in the document's themes part for all text in an East Asian range. ]

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

<hAnsi> (High ANSI Font)

Specifies a font which shall be used to format all characters in a Unicode range within the parent run which does not fall into one of the three categories defined above, which is called the high ANSI range in WordprocessingML.

If the @hAnsiTheme attribute is also specified, then this attribute shall be ignored and that value shall be used instead.

If this attribute is not present, the default value is to leave the formatting applied at previous level in the style hierarchy. If this attribute is never applied in the style hierarchy, then the text shall be displayed in any default font which supports high ANSI content. 

<w:rPr>
  <w:rFonts w:hAnsi=”Bauhaus 93” />
</w:rPr>

The @hAnsi attribute specifies that the run shall use the Bauhaus 93 font for all text in a high ANSI range. ]

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

<hAnsiTheme> (High ANSI Theme Font)

Specifies a theme font which shall be used to format all characters in a Unicode range within the parent run which does not fall into one of the three categories defined above, which is called the high ANSI range in WordprocessingML. This theme font is a reference to one of the predefined theme fonts, located in the document's Theme part,which allows for font information to be set centrally in the document.

If the @hAnsi attribute is also specified, then that attribute shall be ignored and this value shall be used instead.

If this attribute is not present, the default value is to leave the formatting applied at previous level in the style hierarchy. If this attribute is never applied in the style hierarchy, then the text shall be displayed in the font specified by the @hAnsi attribute. 

<w:rPr>
  <w:rFonts w:hAnsiTheme="minorHAnsi" />
</w:rPr>

The @hAnsiTheme attribute specifies that the run shall use the minorHAnsi theme font as defined in the document's themes part for all text in a high ANSI range. ]

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

<hint> (Font Content Type)

Specifies the font type which shall be used to format any ambiguous characters in the current run.

There are certain characters which are not explicitly stored in the document, and may be mapped into multiple categories of the four mentioned above. This attribute shall be used to arbitrate that conflict, and determine how ambiguities in this run shall be handled. [: This is primarily used to handle the formatting on the paragraph mark glyph, and other characters that are not stored as text in the WordprocessingML document. ]

If this attribute is omitted, then this ambiguity may be resolved by any means available.

<w:pPr>
  <w:rPr>
    <w:rFonts w:hint="eastAsia" />
  </w:rPr>
</w:pPr>

The @hint attribute specifies that the run shall use the eastAsia font (theme or not, whichever is in use for East Asian text) as defined for this range. ]

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

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

<complexType name="CT_Fonts">
	<attribute name="hint" type="ST_Hint"/>
	<attribute name="ascii" type="ST_String"/>
	<attribute name="hAnsi" type="ST_String"/>
	<attribute name="eastAsia" type="ST_String"/>
	<attribute name="cs" type="ST_String"/>
	<attribute name="asciiTheme" type="ST_Theme"/>
	<attribute name="hAnsiTheme" type="ST_Theme"/>
	<attribute name="eastAsiaTheme" type="ST_Theme"/>
	<attribute name="cstheme" type="ST_Theme"/>
</complexType>