Export (0) Print
Expand All

TableCellBorders class

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

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

[ChildElementInfoAttribute(typeof(StartBorder), FileFormatVersions.Office2010)]
[ChildElementInfoAttribute(typeof(EndBorder), FileFormatVersions.Office2010)]
[ChildElementInfoAttribute(typeof(InsideHorizontalBorder))]
[ChildElementInfoAttribute(typeof(RightBorder))]
[ChildElementInfoAttribute(typeof(TopBorder))]
[ChildElementInfoAttribute(typeof(LeftBorder))]
[ChildElementInfoAttribute(typeof(BottomBorder))]
[ChildElementInfoAttribute(typeof(TopLeftToBottomRightCellBorder))]
[ChildElementInfoAttribute(typeof(InsideVerticalBorder))]
[ChildElementInfoAttribute(typeof(TopRightToBottomLeftCellBorder))]
public class TableCellBorders : OpenXmlCompositeElement

[ISO/IEC 29500-1 1st Edition]

tcBorders (Table Cell Borders)

This element specifies the set of borders for the edges of the current table cell, using the eight border types defined by its child elements.

If the cell spacing for any row is non-zero as specified using the tblCellSpacing element (§17.4.45; §17.4.44; §17.4.46), then there is never a border conflict (as the non-zero cell spacing is applied above and beyond each individual cell border's width) and all table, table-level exception, and table cell borders shall be displayed.

If the cell spacing is zero, then there can be a conflict between two adjacent cell borders [Example: Between the left border of all cells in the second column and the right border of all cells in the first column of the table. end example], which shall be resolved as follows:

If either conflicting table cell border is nil or none (no border), then the opposing border shall be displayed.

If a cell border conflicts with a table border, the cell border always wins.

Each border shall then be assigned a weight using the following formula, and the border value using this calculation shall be displayed over the alternative border:

The border number shall be determined by this list:

single

1

thick

2

double

3

dotted

4

dashed

5

dotDash

6

dotDotDash

7

triple

8

thinThickSmallGap

9

thickThinSmallGap

10

thinThickThinSmallGap

11

thinThickMediumGap

12

thickThinMediumGap

13

thinThickThinMediumGap

14

thinThickLargeGap

15

thickThinLargeGap

16

thinThickThinLargeGap

17

wave

18

doubleWave

19

dashSmallGap

20

dashDotStroked

21

threeDEmboss

22

threeDEngrave

23

outset

24

inset

25

If the borders have an equal weight, than the higher of the two on this precedence list shall win:

single

thick

double

dotted

dashed

dotDash

dotDotDash

triple

thinThickSmallGap

thickThinSmallGap

thinThickThinSmallGap

thinThickMediumGap

thickThinMediumGap

thinThickThinMediumGap

thinThickLargeGap

thickThinLargeGap

thinThickThinLargeGap

wave

doubleWave

dashSmallGap

dashDotStroked

threeDEmboss

threeDEngrave

outset

inset

If the borders have an identical style, than each border color shall be assigned a brightness value as follows:The color with the smaller brightness value shall win.

If the borders have an identical brightness value above, than each border color shall be assigned a new brightness value as follows:The color with the smaller brightness value shall win.

If the borders have an identical brightness value above, than each border color shall be assigned a brightness value as follows:The color with the smaller brightness value shall win.

If the borders have an identical brightness value above, then they are functionally identical, and the first border in reading order should be displayed.

[Example: Consider the following two cell table (with exaggerated table cell spacing for clarity):

If we collapse the cell spacing, there are conflicting borders at all edges. For each cell/table border conflict, rule #2 says that the cell border must win. For the conflict in the center between two cell borders, rule #3 gives us a larger border weight for the right cell's border, resulting in the following table:

end example]

If this element is omitted, then this table shall have the borders specified by the associated table style. If no borders are specified in the style hierarchy, then this table shall not have any table borders.

[Example: Consider a table whose first cell specifies cell-level borders consisting of a think double red line, as follows:

These cell borders are specified using the following WordprocessingML:

<w:tcPr>
  <w:tcBorders>
    <w:top w:val="double" w:sz="24" w:space="0" w:color="FF0000"/>
    <w:left w:val="double" w:sz="24" w:space="0" w:color="FF0000"/>
    <w:bottom w:val="double" w:sz="24" w:space="0" w:color="FF0000"/>
    <w:right w:val="double" w:sz="24" w:space="0" w:color="FF0000"/>
  </w:tcBorders>
</w:tcPr>

The tcBorders element specifies the set of borders applied to the first cell as a 3 point double border. end example]

Parent Elements

tcPr (§17.7.6.8); tcPr (§17.7.6.9); tcPr (§17.4.70); tcPr (§17.4.71)

Child Elements

Subclause

bottom (Table Cell Bottom Border)

§17.4.3

end (Table Cell Trailing Edge Border)

§17.4.12

insideH (Table Cell Inside Horizontal Edges Border)

§17.4.24

insideV (Table Cell Inside Vertical Edges Border)

§17.4.26

start (Table Cell Leading Edge Border)

§17.4.34

tl2br (Table Cell Top Left to Bottom Right Diagonal Border)

§17.4.74

top (Table Cell Top Border)

§17.4.75

tr2bl (Table Cell Top Right to Bottom Left Diagonal Border)

§17.4.80

[Note: The W3C XML Schema definition of this element’s content model (CT_TcBorders) is located in §A.1. end note]

© ISO/IEC29500: 2008.

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

Community Additions

Show:
© 2014 Microsoft