TableCellBorders 类

定义

命名空间:

DocumentFormat.OpenXml.Wordprocessing

程序集:

DocumentFormat.OpenXml.dll

包:

DocumentFormat.OpenXml v3.0.1

定义 TableCellBorders 类。

此类在 Office 2007 及更高版本中可用。

当对象序列化为 xml 时，其限定名称为 w：tcBorders。

public class TableCellBorders : DocumentFormat.OpenXml.OpenXmlCompositeElement

type TableCellBorders = class
    inherit OpenXmlCompositeElement

Public Class TableCellBorders
Inherits OpenXmlCompositeElement

继承

Object

OpenXmlElement

OpenXmlCompositeElement

TableCellBorders

注解

[ISO/IEC 29500-1 第 1 版]

tcBorders (表格单元格边框)

此元素使用由其子元素定义的八种边框类型，指定当前表单元格边缘的边框集。

如果使用 tblCellSpacing 元素 (§17.4.45 指定的任意行的单元格间距为非零;§17.4.44;§17.4.46) ，则 (不存在边框冲突，因为非零单元格间距应用于每个单元格边框的宽度) 并且将显示所有表格、表级别例外和表格单元格边框。

如果单元格间距为零，则两个相邻单元格边框之间可能存在冲突 [示例：在第二列中所有单元格的左边框与表格第一列中所有单元格的右边框之间。 end example]，应按如下所示进行解析：

如果表单元格边框为零或无 (无边框) ，则应显示对立边框。

如果单元格边框与表格边框冲突，则单元格边框始终获胜。

然后，应使用以下公式为每个边框分配一个权重，并且使用此计算的边框值应显示在备用边框上：

边框编号应由以下列表确定：

单

1

厚

2

double

3

点缀

4

冲

5

dotDash

6

dotDotDash

7

三

8

thinThickSmallGap

9

thickThinSmallGap

10

thinThickThinSmallGap

11

thinThickMediumGap

12

thickThinMediumGap

13

thinThickThinMediumGap

14

thinThickLargeGap

15

thickThinLargeGap

16

thinThickThinLargeGap

17

波

18

doubleWave

19

dashSmallGap

20

dashDotStroked

21

threeDEmboss

22

threeDEngrave

23

开始

24

插图

25

如果边框的权重相等，则比此优先列表中的两个值中的较高值将获胜：

单

厚

double

点缀

冲

dotDash

dotDotDash

三

thinThickSmallGap

thickThinSmallGap

thinThickThinSmallGap

thinThickMediumGap

thickThinMediumGap

thinThickThinMediumGap

thinThickLargeGap

thickThinLargeGap

thinThickThinLargeGap

波

doubleWave

dashSmallGap

dashDotStroked

threeDEmboss

threeDEngrave

开始

插图

如果边框的样式相同，应为每个边框颜色分配一个亮度值，如下所示：亮度值较小的颜色将获胜。

如果以上边框的亮度值相同，应为每个边框颜色分配一个新的亮度值，如下所示：亮度值较小的颜色将获胜。

如果边框的亮度值相同，则每个边框颜色应分配如下亮度值：亮度值较小的颜色将获胜。

如果边框的亮度值相同，则它们在功能上相同，并且应显示阅读顺序中的第一个边框。

[示例：考虑以下两个单元格表 (，加宽表格单元格间距，以明确) ：

如果折叠单元格间距，则所有边缘都有冲突的边框。 对于每个单元格/表边框冲突，规则 #2 表示单元格边框必须获胜。 对于两个单元格边框之间的中心冲突，规则 #3 为右侧单元格的边框提供了更大的边框权重，结果如下表：

示例结束]

如果省略此元素，则此表应具有由关联的表样式指定的边框。 如果未在样式层次结构中指定边框，则此表不应具有任何表边框。

[示例：考虑一个表，其第一个单元格指定由思考双红线组成的单元格级边框，如下所示：

使用以下 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>  

tcBorders 元素将应用于第一个单元格的边框集指定为 3 磅 双 边框。 示例结束]

父元素
tcPr (§17.7.6.8) ;tcPr (§17.7.6.9) ;tcPr (§17.4.70) ;tcPr (§17.4.71)

子元素	第
底部 (表格单元格底部边框)	§17.4.3
结束 (表格单元格尾随边缘边框)	§17.4.12
insideH (表格单元格内水平边缘边框)	§17.4.24
insideV (表格单元格内垂直边缘边框)	§17.4.26
开始 (表格单元格前导边缘边框)	§17.4.34
tl2br (表格单元格从左到右下对角线边框)	§17.4.74
top (Table Cell 上边框)	§17.4.75
tr2bl (表格单元格从右上到左下对角线边框)	§17.4.80

[注意：此元素的内容模型 (CT_TcBorders) 的 W3C XML 架构定义位于 §A.1 中。 注释结束]

ISO/IEC29500：2008。

构造函数

TableCellBorders()	初始化 TableCellBorders 类的新实例。
TableCellBorders(IEnumerable<OpenXmlElement>)	使用指定的子元素初始化 TableCellBorders 类的新实例。
TableCellBorders(OpenXmlElement[])	使用指定的子元素初始化 TableCellBorders 类的新实例。
TableCellBorders(String)	从外部 XML 初始化 TableCellBorders 类的新实例。

属性

BottomBorder	表格单元格底部边框。 表示架构中的以下元素标记：w：bottom。
ChildElements	获取当前元素的所有子节点。 (继承自 OpenXmlElement)
EndBorder	EndBorder，此属性仅在 Office 2010 及更高版本中可用。 表示架构中的以下元素标记：w：end。
ExtendedAttributes	获取当前元素的架构) 中未定义的所有扩展属性 (属性。 (继承自 OpenXmlElement)
Features	IFeatureCollection获取当前元素的 。 此功能集合将是只读的，但会从其父部件和包继承功能（如果可用）。 (继承自 OpenXmlElement)
FirstChild	获取当前 OpenXmlElement 元素的第一个子元素。 (继承自 OpenXmlCompositeElement)
HasAttributes	获取一个值，该值指示当前元素是否具有任何属性。 (继承自 OpenXmlElement)
HasChildren	获取一个值，该值指示当前元素是否具有任何子元素。 (继承自 OpenXmlCompositeElement)
InnerText	获取或设置当前节点及其所有子节点的串联值。 (继承自 OpenXmlCompositeElement)
InnerXml	获取或设置仅表示当前节点的子节点的标记。 (继承自 OpenXmlCompositeElement)
InsideHorizontalBorder	水平边缘边框内的表格单元格。 表示架构中的以下元素标记：w：insideH。
InsideVerticalBorder	垂直边缘边框内的表格单元格。 表示架构中的以下元素标记：w：insideV。
LastChild	获取当前 OpenXmlElement 元素的最后一个子元素。 如果没有这样的 OpenXmlElement 元素，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlCompositeElement)
LeftBorder	表格单元格左边框。 表示架构中的以下元素标记：w：left。
LocalName	获取当前元素的本地名称。 (继承自 OpenXmlElement)
MCAttributes	获取或设置标记兼容性属性。 如果未为当前元素定义标记兼容性属性，则返回 null。 (继承自 OpenXmlElement)
NamespaceDeclarations	获取在当前元素中定义的所有命名空间声明。 如果没有命名空间声明，则返回空枚举器。 (继承自 OpenXmlElement)
NamespaceUri	获取当前元素的命名空间 URI。 (继承自 OpenXmlElement)
OpenXmlElementContext	获取当前元素的 OpenXmlElementContext。 (继承自 OpenXmlElement)
OuterXml	获取表示当前元素及其所有子元素的标记。 (继承自 OpenXmlElement)
Parent	获取当前元素的父元素。 (继承自 OpenXmlElement)
Prefix	获取当前元素的命名空间前缀。 (继承自 OpenXmlElement)
RightBorder	表格单元格右边框。 表示架构中的以下元素标记：w：right。
StartBorder	StartBorder，此属性仅在 Office 2010 及更高版本中可用。 表示架构中的以下元素标记：w：start。
TopBorder	表格单元格上边框。 表示架构中的以下元素标记：w：top。
TopLeftToBottomRightCellBorder	表格单元格从左上到右下对角线边框。 表示架构中的以下元素标记：w：tl2br。
TopRightToBottomLeftCellBorder	表格单元格从右上到下左对角线边框。 表示架构中的以下元素标记：w：tr2bl。
XmlQualifiedName	获取当前元素的限定名称。 (继承自 OpenXmlElement)
XName	获取当前元素的限定名称。 (继承自 OpenXmlElement)

方法

AddAnnotation(Object)	将 对象添加到当前 OpenXmlElement 元素的批注列表中。 (继承自 OpenXmlElement)
AddChild(OpenXmlElement, Boolean)	如果指定元素是已知的子元素，则将其添加到 元素。 这会根据架构将 元素添加到正确的位置。 (继承自 OpenXmlCompositeElement)
AddNamespaceDeclaration(String, String)	将命名空间声明添加到当前节点。 (继承自 OpenXmlElement)
Ancestors()	枚举当前元素的所有上级。 (继承自 OpenXmlElement)
Ancestors<T>()	仅枚举具有指定类型的当前元素的上级。 (继承自 OpenXmlElement)
Annotation(Type)	从当前 OpenXmlElement 元素获取指定类型的第一个批注对象。 (继承自 OpenXmlElement)
Annotation<T>()	从当前 OpenXmlElement 元素获取指定类型的第一个批注对象。 (继承自 OpenXmlElement)
Annotations(Type)	获取具有当前 OpenXmlElement 元素的指定类型的批注的集合。 (继承自 OpenXmlElement)
Annotations<T>()	获取具有当前 OpenXmlElement 元素的指定类型的批注的集合。 (继承自 OpenXmlElement)
Append(IEnumerable<OpenXmlElement>)	将元素列表中的每个元素追加到当前元素的子元素列表的末尾。 (继承自 OpenXmlElement)
Append(OpenXmlElement[])	将元素数组中的每个元素追加到当前元素的子元素列表的末尾。 (继承自 OpenXmlElement)
AppendChild<T>(T)	将指定的元素追加到当前元素的子节点列表的末尾。 (继承自 OpenXmlCompositeElement)
ClearAllAttributes()	清除所有属性，包括已知属性和扩展属性。 (继承自 OpenXmlElement)
Clone()	创建当前节点的副本。 (继承自 OpenXmlElement)
CloneNode(Boolean)	创建此节点的副本。
Descendants()	枚举当前元素的所有后代。 (继承自 OpenXmlElement)
Descendants<T>()	枚举类型为 T 的当前元素的所有后代。 (继承自 OpenXmlElement)
Elements()	枚举当前元素的所有子元素。 (继承自 OpenXmlElement)
Elements<T>()	仅枚举具有指定类型的当前元素的子元素。 (继承自 OpenXmlElement)
ElementsAfter()	枚举与当前元素相同的父级的所有同级元素。 (继承自 OpenXmlElement)
ElementsBefore()	枚举当前元素之前且具有与当前元素相同的父级的所有同级元素。 (继承自 OpenXmlElement)
GetAttribute(String, String)	获取具有指定标记名称和命名空间 URI 的 Open XML 属性。 (继承自 OpenXmlElement)
GetAttributes()	获取一个列表，该列表包含所有属性的副本。 (继承自 OpenXmlElement)
GetEnumerator()	返回循环访问子集合的枚举器。 (继承自 OpenXmlElement)
GetFirstChild<T>()	查找类型 T 中的第一个子元素。 (继承自 OpenXmlElement)
InsertAfter<T>(T, OpenXmlElement)	在指定的引用元素之后立即插入指定的元素。 (继承自 OpenXmlCompositeElement)
InsertAfterSelf<T>(T)	在当前元素之后立即插入指定的元素。 (继承自 OpenXmlElement)
InsertAt<T>(T, Int32)	在当前元素的子元素的指定索引处插入指定的元素。 (继承自 OpenXmlCompositeElement)
InsertBefore<T>(T, OpenXmlElement)	将指定的元素紧接在指定的引用元素之前。 (继承自 OpenXmlCompositeElement)
InsertBeforeSelf<T>(T)	将指定的元素紧接在当前元素的前面。 (继承自 OpenXmlElement)
IsAfter(OpenXmlElement)	确定当前元素是否以文档顺序显示在指定元素之后。 (继承自 OpenXmlElement)
IsBefore(OpenXmlElement)	确定当前元素是否按文档顺序显示在指定元素之前。 (继承自 OpenXmlElement)
LookupNamespace(String)	解析当前节点上下文中的命名空间前缀。 (继承自 OpenXmlElement)
LookupPrefix(String)	查找当前元素范围内命名空间 URI 的相应前缀。 (继承自 OpenXmlElement)
NextSibling()	获取紧跟在当前 OpenXmlElement 元素后面的 OpenXmlElement 元素。 如果没有下一个 OpenXmlElement 元素，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlElement)
NextSibling<T>()	获取具有当前 OpenXmlElement 元素后面的指定类型的 OpenXmlElement 元素。 如果没有下一个 OpenXmlElement，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlElement)
PrependChild<T>(T)	在当前元素的子节点列表的开头插入指定的元素。 (继承自 OpenXmlCompositeElement)
PreviousSibling()	获取紧接在当前 OpenXmlElement 元素之前的 OpenXmlElement 元素。 如果没有前面的 OpenXmlElement 元素，则返回 null (Visual Basic ) 中 Nothing。 (继承自 OpenXmlElement)
PreviousSibling<T>()	获取位于当前 OpenXmlElement 之前的指定类型的 OpenXmlElement 元素。 如果没有前面的 OpenXmlElement 元素，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlElement)
Remove()	从其父元素中删除当前元素。 (继承自 OpenXmlElement)
RemoveAllChildren()	删除当前元素的所有子元素。 (继承自 OpenXmlCompositeElement)
RemoveAllChildren<T>()	删除类型为 T 的当前元素的所有子元素。 (继承自 OpenXmlElement)
RemoveAnnotations(Type)	从当前 OpenXmlElement 元素中删除指定类型的注释。 (继承自 OpenXmlElement)
RemoveAnnotations<T>()	从当前 OpenXmlElement 元素中删除具有指定类型的批注。 (继承自 OpenXmlElement)
RemoveAttribute(String, String)	从当前元素中删除 属性。 (继承自 OpenXmlElement)
RemoveChild<T>(T)	删除指定的子元素。 (继承自 OpenXmlCompositeElement)
RemoveNamespaceDeclaration(String)	删除指定前缀的命名空间声明。 如果没有前缀，则不删除任何内容。 (继承自 OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)	将当前元素的子元素之一替换为另一个 OpenXmlElement 元素。 (继承自 OpenXmlCompositeElement)
SetAttribute(OpenXmlAttribute)	将特性设置为指定的元素。 如果该属性是已知属性，则设置该特性的值。 如果该属性是扩展属性，则会将“openxmlAttribute”添加到扩展属性列表中。 (继承自 OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)	设置元素的多个属性。 如果属性是已知属性，则会设置该属性的值。 如果属性是扩展属性，则会将“openxmlAttribute”添加到扩展属性列表中。 (继承自 OpenXmlElement)
WriteTo(XmlWriter)	将当前节点保存到指定的 XmlWriter。 (继承自 OpenXmlElement)

显式接口实现

IEnumerable.GetEnumerator()	定义 TableCellBorders 类。 此类在 Office 2007 及更高版本中可用。 当对象序列化为 xml 时，其限定名称为 w：tcBorders。 (继承自 OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	返回循环访问子集合的枚举器。 (继承自 OpenXmlElement)