<color> (Run Content Color)

This element specifies the color which shall be used to display the contents of this run in the document.

This color may be explicitly specified, or set to allow the consumer to automatically choose an appropriate color based on the background color behind the run's content.

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 set to allow the consumer to automatically choose an appropriate color based on the background color behind the run's content.

example: 
<w:rPr>
  <w:color w:themeColor=”accent3” />
</w:rPr>

The @color attribute specifies that the run shall use the accent3 theme color. ]

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

<themeColor> (Run Content Theme Color)

Specifies a theme color which should be applied to the current run.

The specified theme color is a reference to one of the predefined theme colors, located in the document's Theme part,which allows for color information to be set centrally in the document.

If the @themeColor attribute is specified, then the @val attribute is ignored for this run.

<w:rPr>
  <w:color w:themeColor=”accent3” />
</w:rPr>

The @color attribute specifies that the run shall use the accent3 theme color. ]

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

<themeShade> (Run Content Theme Color Shade)

Specifies the shade value applied to the supplied theme color (if any) for this run’s contents.

If the @themeShade is supplied, then it is applied to the RGB value of the theme color to determine the final color applied to this run.

The @themeShade value is stored as a hex encoding of the shade value (from 0 to 255) applied to the current border.

Te resulting @themeShade value in the file format would be 66. ]

Given a input red, green, or blue color value C (from 0-255), an output color value of C' (from 0-255), and a shade value S (from 0-100), the shade is applied as follows:

The hex value for the green component is 96 - 150 in decimal. Applying the shade formula with shade of 50%, the output decimal value of the green component is 75, or a hex value of 4B. This transformed value can be seen in the resulting run color WordprocessingML's @val attribute:

<w:color w:val="7B4B23" w:themeColor="accent6" w:themeShade="80" />

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

<themeTint> (Run Content Theme Color Tint)

Specifies the tint value applied to the supplied theme color (if any) for this run’s contents.

If the @themeTint is supplied, then it is applied to the RGB value of the theme color to determine the final color applied to this run.

The @themeTint value is stored as a hex encoding of the tint value (from 0 to 255) applied to the current border.

The resulting @themeTint value in the file format would be 99. ]

Given a input red, green, or blue color value C (from 0-255), an output color value of C' (from 0-255), and a tint value T (from 0-100), the tint is applied as follows:

The hex value for the green component is 50 - 80 in decimal. Applying the tint formula with tint of 60%, the output decimal value of the green component is 150, or a hex value of 96. This transformed value can be seen in the resulting run color's WordprocessingML @val attribute:

<w:color w:val="D99694" w:themeColor="accent1" w:themeTint="99" />

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

<val> (Run Content Color)

Specifies the color for this run.

This color may either be presented as a hex value (in RRGGBB format), or auto to allow a consumer to automatically determine the run color as appropriate.

If the run specifies the use of a theme color via the @themeColor attribute, then this value is superseded by the theme color value.

<w:rPr>
  <w:color ... w:val="auto" />
</w:rPr>

This color therefore may be automatically be modified by a consumer as appropriate, for example, in order to ensure that the run contents can be distinguished against the page's background color. ]

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

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

<complexType name="CT_Color">
	<attribute name="val" type="ST_HexColor" use="required"/>
	<attribute name="themeColor" type="ST_ThemeColor" use="optional"/>
	<attribute name="themeTint" type="ST_UcharHexNumber" use="optional"/>
	<attribute name="themeShade" type="ST_UcharHexNumber" use="optional"/>
</complexType>