17.4.31 shd

This element specifies the shading which shall be applied to the extents the current table. 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 via any table-level property exceptions (17.4.30); or on any cell in this row (17.4.32).

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 cells within this table shall have the shading specified by the associated table style. If no cell shading is specified in the style hierarchy, then the cells in this table shall not have any cell shading (i.e. they shall be transparent).

[Example: Consider a table in which the first

cell in the first row

has cell-level red shading, as follows:

R1C1

R1C2

R2C1

R2C2

This table level cell shading would be specified using the following WordprocessingML:

<w:tbl>
  <w:tblPr>
    <w:shd w:val="clear" w:color="auto" w:fill="FF0000"/>
    …
  </w:tblPr>
  …
</w:tbl>

The shd element specifies cell shading with a clear pattern using a background color of FF0000 (red). end example]

This element’s content model is defined by the common shading properties definition in 17.3.5.