Office Open XML
17 WordprocessingML Reference Material
17.15 Settings
17.15.2 Web Page Settings
17.15.2.5 color

17.15.2.5 color

This element specifies the color of the splitters within the frameset in this WordprocessingML document. This element shall only be honored on the root frameset for this document, and can be ignored for all nested framesets in this document.

If this element is omitted, then the default color of the splitter can be automatically determined by the application displaying this WordprocessingML document (equivalent to a val attribute value of auto).

[Example: Consider a frameset consisting of the following three frames:

image

The following properties define the presentation of the splitter bars within this frameset:

<w:frameset>
  <w:framesetSplitbar>
    <w:w w:val="200" />
    <w:color w:val="0000FF" />
  </w:framesetSplitbar>
  …
</w:frameset>

The color element’s val attribute specifies that the splitters must be displayed in the RGB color 0000FF (blue) when the contents of this document are displayed. end example]

Attributes

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 themeTint is supplied, the value of this attribute shall be ignored.

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.

[Example: Consider a shade of 40% applied to a run in a document. This shade is calculated as follows:

$$ 𝑆 _{π‘₯π‘šπ‘™} = 0.4 βˆ— 255\\ = 102\\ = 66(β„Žπ‘’π‘₯) $$

The resulting themeShade value in the file format would be 66. end example]

Given an 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:

$$ 𝑆\\ 𝐢 _{β€²} = (1 βˆ’ )C\\ 100 $$

[Example: Consider a document with a run using the accent6 theme color, whose RGB value (in RRGGBB hex format) is F79646.

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" />

end example]

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

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.

[Example: Consider a run of text which should be displayed using the accent3 theme color from the document’s Theme part. This requirement would be specified as follows in the resulting WordprocessingML:

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

The color attribute specifies that the run must use the accent3 theme color. end example]

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

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.

[Example: Consider a tint of 60% applied to a run in a document. This tint is calculated as follows:

$$ 𝑇 _{π‘₯π‘šπ‘™} = 0.6 βˆ— 255\\ = 153\\ = 99(β„Žπ‘’π‘₯) $$

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

Given an 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:

$$ 𝑇\\ 𝐢 _{β€²} = (1 βˆ’ )(255 βˆ’ C) + C\\ 100 $$

[Example: Consider a document with a run using the accent1 theme color, whose RGB value (in RRGGBB hex format) is C0504D.

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"
    />

end example]

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

val (Run Content Color)

Specifies the color for this run.

This color can 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.

[Example: Consider a run color with value auto, as follows:

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

This color therefore can 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. end example]

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

[Note: The W3C XML Schema definition of this element’s content model (CT_Color) is located in A.1. end note]

Last updated on
17.15.2.4 bottom17.15.2.6 div