<shd>
(Table Shading Exception)
This element specifies the shading which shall be applied to all cells in the current row as part of a set of table-level property exceptions. Similarly to paragraph shading, this shading shall be applied to the contents of the tab up to the table borders, regardless of the presence of text - unlike cell shading, table shading shall include any cell padding. This property shall be superseded by any cell-level shading on any cell in this row (§2.4.33).
This shading consists of three components:
Background Color
(optional) Pattern
(optional) Pattern Color
The resulting shading is applied by setting the background color behind the paragraph, then applying the pattern color using the mask supplied by the pattern over that background.
If this element is omitted, then the cell shading shall be determined by the table-level cell shading settings (§2.4.35) for the current table.
This table-level shading exception would be specified using the following WordprocessingML:
<w:tblPrEx> <w:jc w:val="left" /> <w:shd w:val="clear" w:color="auto" w:fill="EEECE1" w:themeFill="background2" /> </w:tblPrEx>
The <shd>
element specifies cell shading with a clear
pattern using a background theme color of background2
. ]
Attributes |
Description |
---|---|
|
Specifies the color used for any foreground pattern specified for this shading using the This color may either be presented as a hex value (in RRGGBB format), or If the shading style (the If this attribute is omitted, then its value shall be assumed to be <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 If this attribute is omitted, then its value shall be assumed to be <w:shd w:fill="C3D69B" /> The background color for this shading therefore will be a color with a hex value of If the shading specifies the use of a theme color via the 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 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 <w:pPr> <w:shd w:val="pct20" w:themeColor="accent6" w:themeFill="accent3" /> </w:pPr> The resulting paragraph will use the foreground pattern color 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 <w:shd w:val="pct20" w:themeColor="accent6" w:themeFill="accent3" /> The resulting shading will use the background color specified by the 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 The The resulting Given an RGB color defined as three hex values in RRGGBB format, the shade is applied as follows:
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 This transformed value can be seen in the resulting shading's <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 The The resulting Given an RGB color defined as three hex values in RRGGBB format, the shade is applied as follows:
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 This transformed value can be seen in the resulting shading's <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 The Te resulting Given an RGB color defined as three hex values in RRGGBB format, the shade is applied as follows:
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 This transformed value can be seen in the resulting background's <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 The The resulting Given an RGB color defined as three hex values in RRGGBB format, the shade is applied as follows:
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 This transformed value can be seen in the resulting shading's <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). |
|
Specifies the pattern which shall be used to lay the pattern color over the background color for this paragraph shading. This pattern consists of a mask which is applied over the background shading color to get the locations where the pattern color should be shown. Each of these possible masks are shown in the simple type values referenced below. <w:shd w:val="pct10" .../> This shading The possible values for this attribute are defined by the ST_Shd simple type (§2.18.85). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_Shd">
<attribute name="val" type="ST_Shd" use="required"/>
<attribute name="color" type="ST_HexColor" use="optional"/>
<attribute name="themeColor" type="ST_ThemeColor" use="optional"/>
<attribute name="themeTint" type="ST_UcharHexNumber" use="optional"/>
<attribute name="themeShade" type="ST_UcharHexNumber" use="optional"/>
<attribute name="fill" type="ST_HexColor" use="optional"/>
<attribute name="themeFill" type="ST_ThemeColor" use="optional"/>
<attribute name="themeFillTint" type="ST_UcharHexNumber" use="optional"/>
<attribute name="themeFillShade" type="ST_UcharHexNumber" use="optional"/>
</complexType>