DocumentID: ECMA-376/Part4/2.4.41
Title: ECMA-376, Part4: 2.4.41 tblCellSpacing (Table Cell Spacing Exception)
Extracted-From: ECMA-376 Office Open XML File Formats, 1st Edition / December 2006
Warning: Coverted to HTML format by a script known to have bugs

Navigation:

Next: 2.4.42 tblCellSpacing (Table Row Cell Spacing)
Up: 2.4 Tables
Table of contents: Table of contents
Previous: 2.4.40 tblCellMar (Table Cell Margin Exceptions)

`2.4.41 tblCellSpacing` (Table Cell Spacing Exception)

This element specifies a table cell spacing exception for all cells in the parent table row as part of a set of table-level property exceptions. If specified, this element specifies the minimum amount of space which shall be left between all cells in the parent row after including the width of the table borders in the calculation. This setting shall be superseded by the row cell spacing value (§2.4.42). 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 row shall inherit the table cell spacing from the table-level cell spacing setting (§2.4.39), excepting the case of a row level override.

[Example: Consider a table whose final two rows are defined to have cell spacing of 0.1 inches for all sides via a table-level property exception, as follows:

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

<w:tblPrEx> <w:tblCellSpacing w:w="144" w:type="dxa"> ... </w:tblPrEx>

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

Parent Elements

tblPrEx (§2.4.57); tblPrEx (§2.4.58)

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 type (§2.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 type (§2.18.16).

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 type (§2.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 type (§2.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>

Converted to HTML format by ooxmlspec2html 0.1, a Perl script provided by OpenISO.org.