TableCellSpacing Class

Defines the TableCellSpacing Class.When the object is serialized out as xml, its qualified name is w:tblCellSpacing.

Inheritance Hierarchy

System.Object
  DocumentFormat.OpenXml.OpenXmlElement
    DocumentFormat.OpenXml.OpenXmlLeafElement
      DocumentFormat.OpenXml.Wordprocessing.TableWidthType
        DocumentFormat.OpenXml.Wordprocessing.TableCellSpacing

Namespace:  DocumentFormat.OpenXml.Wordprocessing
Assembly:  DocumentFormat.OpenXml (in DocumentFormat.OpenXml.dll)

Syntax

'Declaration
Public Class TableCellSpacing _
    Inherits TableWidthType
'Usage
Dim instance As TableCellSpacing

public class TableCellSpacing : TableWidthType

Remarks

[ISO/IEC 29500-1 1st Edition]

17.4.44 tblCellSpacing (Table Row Cell Spacing)

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 row. 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. It is important to note that row-level cell spacing shall be added inside of the text margins, which shall be aligned with the innermost starting edge of the text extents in a cell without row-level indentation or cell spacing. Row-level cell spacing shall not increase the width of the overall table.

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 cells in this row shall inherit the cell spacing from the associated table level properties.

[Example: Consider a table where the second row has a cell spacing of 0.1 inches for all sides specified via the table row properties as follows:

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

<w:trPr>
<w:tblCellSpacing w:w="144" w:type="dxa"/>
…
</w:trPr>

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

This element’s content model is defined by the common table measurement definition in §17.4.88.

[ISO/IEC 29500-1 1st Edition]

17.4.45 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 (§17.4.44). 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 (§17.4.43), 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]

This element’s content model is defined by the common table measurement definition in §17.4.88.

[ISO/IEC 29500-1 1st Edition]

17.4.46 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 (§17.4.45) or the row cell spacing value (§17.4.44) 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]

This element’s content model is defined by the common table measurement definition in §17.4.88.

© ISO/IEC29500: 2008.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

See Also

Reference

TableCellSpacing Members

DocumentFormat.OpenXml.Wordprocessing Namespace