<shd> (Paragraph Shading)

Specifies the color used for any foreground pattern specified for this shading using the @val attribute.

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

If the shading style (the @val attribute) specifies the use of no shading format or is omitted, then this property has no effect. Also, if the shading specifies the use of a theme color via the @themeColor attribute, then this value is superseded by the theme color value.

If this attribute is omitted, then its value shall be assumed to be auto.

<w:shd w:val="pct20"... w:color="auto"/>

The foreground color for this shading pattern therefore may be automatically be modified by a consumer as appropriate, for example, in order to ensure that the shading color 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).

Specifies the color used for the background for this shading.

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

If this attribute is omitted, then its value shall be assumed to be auto.

<w:shd w:fill="C3D69B" />

The background color for this shading therefore will be a color with a hex value of C3D69B. ]

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

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

Specifies a theme color which should be applied to any foreground pattern specified for this shading using the @val attribute.

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

If this element is omitted, then no theme color is applied, and the @color attribute shall be used to determine the shading pattern color.

<w:pPr>
  <w:shd w:val="pct20" w:themeColor="accent6" w:themeFill="accent3" /> 
</w:pPr>

The resulting paragraph will use the foreground pattern color accent6 in the region specified by the pct20 pattern mask. ]

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

Specifies a theme color which should be applied to the background for this shading.

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

If this element is omitted, then no theme color is applied, and the @color attribute shall be used to determine the shading background color.

<w:shd w:val="pct20" w:themeColor="accent6" w:themeFill="accent3" /> 

The resulting shading will use the background color specified by the accent3 theme color. ]

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

Specifies the shade value applied to the supplied theme color (if any) for this shading color.

If the @themeFillShade is supplied, then it is applied to the RGB value of the <themeFill> color (from the theme part) to determine the final color applied to this border.

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

The resulting @themeFillShade value in the file format would be 66. ]

Given an RGB color defined as three hex values in RRGGBB format, the shade is applied as follows:

• Convert the color to the HSL color format (values from 0 to 1)

• Modify the luminance factor as follows:

• Convert the resultant HSL color to RGB

The equivalent HSL color value would be.

Applying the shade formula with a shade percentage of 75% to the luminance, we get:

Taking the resulting HSL color value of and converting back to RGB, we get 943634.

This transformed value can be seen in the resulting shading's @fill attribute:

<w:shd w:fill="943634" w:themeFill="accent2"
  w:themeFillShade="BF" />

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

Specifies the tint value applied to the supplied theme color (if any) for this shading instance.

If the @themeFillTint is supplied, then it is applied to the RGB value of the <themeFill> color (from the theme part) to determine the final color applied to this border.

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

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

Given an RGB color defined as three hex values in RRGGBB format, the shade is applied as follows:

• Convert the color to the HSL color format (values from 0 to 1)

• Modify the luminance factor as follows:

• Convert the resultant HSL color to RGB

The equivalent HSL color value would be.

Applying the tint formula with a tint percentage of 60% to the luminance, we get:

Taking the resulting HSL color value of and converting back to RGB, we get 95B3D7.

This transformed value can be seen in the resulting shading's @fill attribute:

<w:top w:val="single" w:sz="4" w:space="24" 
  w:fill="95B3D7" w:themeFillColor="accent2" 
  w:themeFillTint="99" />

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

Specifies the shade value applied to the supplied theme color (if any) for this shading color.

If the @themeShade is supplied, then it is applied to the RGB value of the <themeColor> color (from the theme part) to determine the final color applied to this border.

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 an RGB color defined as three hex values in RRGGBB format, the shade is applied as follows:

• Convert the color to the HSL color format (values from 0 to 1)

• Modify the luminance factor as follows:

• Convert the resultant HSL color to RGB

The equivalent HSL color value would be.

Applying the shade formula with a shade percentage of 75% to the luminance, we get:

Taking the resulting HSL color value of and converting back to RGB, we get 943634.

This transformed value can be seen in the resulting background's @color attribute:

<w:shd w:color="943634" w:themeColor="accent2"
  w:themeShade="BF" />

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

Specifies the tint value applied to the supplied theme color (if any) for this shading instance.

If the @themeTint is supplied, then it is applied to the RGB value of the <themeColor> color (from the theme part) to determine the final color applied to this border.

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 an RGB color defined as three hex values in RRGGBB format, the shade is applied as follows:

• Convert the color to the HSL color format (values from 0 to 1)

• Modify the luminance factor as follows:

• Convert the resultant HSL color to RGB

The equivalent HSL color value would be.

Applying the tint formula with a tint percentage of 60% to the luminance, we get:

Taking the resulting HSL color value of and converting back to RGB, we get 95B3D7.

This transformed value can be seen in the resulting shading's @color attribute:

<w:shd w:color="95B3D7" w:themeColor="accent2" 
  w:themeTint="99" />

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