[Table of Contents] [docx version]

WordprocessingML Reference Material - Table of Contents

tblCellSpacing (Table Cell Spacing Default)

This element specifies the default table cell spacing (the spacing between adjacent cells and the edges of the table) for all cells in the parent table. If specified, this element specifies the minimum amount of space which shall be left between all cells in the table including the width of the table borders in the calculation. This setting shall be superseded by a table-level exception (§2.4.41) or the row cell spacing value (§2.4.42) in that order. It is important to note that table-level cell spacing shall be added outside of the text margins, which shall be aligned with the innermost starting edge of the text extents in a table cell.

This value is specified in the units applied via its type attribute. Any width value of type pct or auto for this element shall be ignored.

[Example: Consider a table whose first cell has a six point wide table border, and a table cell spacing value of 0.01 inches. The resulting table would have 0.01 inches of space between each table cell regardless of the width of the cell border, as follows (notice that no border is covered by any other border):

R1C1

R1C2

R2C1

R2C2

 

end example]

If this element is omitted, then the table shall inherit the table cell spacing from the associated table style. If table cell spacing is never specified in the style hierarchy, no cell spacing shall be added to the parent table.

[Example: Consider a table with a default cell spacing of 0.1 inches for all sides as follows:

R1C1

R1C2

R2C1

R2C2

 

This table cell spacing deafult is specified using the following WordprocessingML:

<w:tblPr>
<w:tblCellSpacing w:w="144" w:type="dxa">

</w:tblPr>

The tblCellSpacing element as a child of tblPr specifies the default cell spacing between all cells in the current table, in this case 144 twentieths of a point. end example]

Parent Elements

tblPr2.7.5.3); tblPr2.7.5.4); tblPr2.4.55); tblPr2.4.56)

 

Attributes

Description

type (Table Width Type)

Specifies the units of the width property being defined by the parent element’s w attribute. This property is used to define various properties of a table, including: cell spacing, preferred width, and table margins.

 

If this attribute is omitted, then its value shall be assumed to be dxa (twentieths of a point).

 

[Example: Consider a table with a table cell bottom cell spacing with a type of dxa, as follows:

 

<w:bottom ... w:type="dxa" />

 

This type shall therefore be used to interpret the width specified in the w attribute as a value in twentieths of a point. end example]

 

The possible values for this attribute are defined by the ST_TblWidth simple type2.18.97).

w (Table Width Value)

Specifies the value of the width property being defined by the parent element. This property is used to define various properties of a table, including: cell spacing, preferred widths, and table margins.

 

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

 

[Example: Consider a table with a bottom margin with a width of 302, as follows:

 

<w:bottom w:w="302" w:type="dxa" />

 

The value in the w attribute shall therefore be used to determine the width being specified in the context of the units specified in the type attribute. In this case, the type is twentieths of a point (dxa), so the width is 302 twentieths of a point (.2097 inches). end example]

 

The possible values for this attribute are defined by the ST_DecimalNumber simple type2.18.16).

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

<complexType name="CT_TblWidth">

   <attribute name="w" type="ST_DecimalNumber"/>

   <attribute name="type" type="ST_TblWidth"/>

</complexType>