tblPr (Table Properties)

This element specifies the set of table-wide properties applied to the current table. These properties affect the appearance of all rows and cells within the parent table, but may be overridden by individual table-level exception, row, and cell level properties as defined by each property.

[Example: Consider the following simple WordprocessingML table:

 

This table defines a one point single border for all border types and is set to 100% of page width - both table-wide properties. The resulting table is represented by the following WordprocessingML:

<w:tbl>
<w:tblPr>
<w:tblW w:w="0" w:type="auto"/>
<w:tblBorders>
<w:top w:val="single" w:sz="4" w:space="0" w:color="auto"/>
<w:left w:val="single" w:sz="4 w:space="0" w:color="auto"/>
<w:bottom w:val="single" w:sz="4" w:space="0" w:color="auto"/>
<w:right w:val="single" w:sz="4" w:space="0" w:color="auto"/>
<w:insideH w:val="single" w:sz="4" w:space="0" w:color="auto"/>
<w:insideV w:val="single" w:sz="4" w:space="0" w:color="auto"/>
</w:tblBorders>
</w:tblPr>
…
</w:tbl>

In this example, the tblW element (§2.4.61) defines the total width of the table, which, in this case, is set to a type of auto, which specifies that the table should be automatically sized to fit its contents. The tblBorders element (§2.4.38) specifies each of the table's borders, and specifies a one point border on the top, left, bottom, right and inside horizontal and vertical border. end example]

Parent Elements

tbl (§2.4.36)

 

Child Elements	Subclause
bidiVisual (Visually Right to Left Table)	§2.4.1
jc (Table Alignment)	§2.4.23
shd (Table Shading)	§2.4.35
tblBorders (Table Borders)	§2.4.38
tblCellMar (Table Cell Margin Defaults)	§2.4.39
tblCellSpacing (Table Cell Spacing Default)	§2.4.43
tblInd (Table Indent from Leading Margin)	§2.4.48
tblLayout (Table Layout)	§2.4.49
tblLook (Table Style Conditional Formatting Settings)	§2.4.51
tblOverlap (Floating Table Allows Other Tables to Overlap)	§2.4.53
tblpPr (Floating Table Positioning)	§2.4.54
tblPrChange (Revision Information for Table Properties)	§2.13.5.36
tblStyle (Referenced Table Style)	§2.4.59
tblStyleColBandSize (Number of Columns in Column Band)	§2.7.5.5
tblStyleRowBandSize (Number of Rows in Row Band)	§2.7.5.7
tblW (Preferred Table Width)	§2.4.61

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

<complexType name="CT_TblPr">

   <complexContent>

   <extension base="CT_TblPrBase">

   <sequence>

   <element name="tblPrChange" type="CT_TblPrChange" minOccurs="0"/>

   </sequence>

   </extension>

   </complexContent>

</complexType>