Table

概述

Table 是 Aspose.Words FOSS 中用于 .NET 的类。继承自：CompositeNode。

表示 Word 文档中的表格。

此类提供 35 个用于在 .NET 程序中操作 Table 对象的方法。可用的方法包括：Accept、AcceptEnd、AcceptStart、AppendChild、AutoFit、ClearBorders、ClearShading、Clone、ConvertToHorizontallyMergedCells、CreateNavigator、EnsureMinimum、GetAncestor，以及另外 23 个方法。安装 Aspose.Words FOSS for .NET 包后，所有公共成员对任何 .NET 应用程序均可访问。属性包括：AbsoluteHorizontalDistance、AbsoluteVerticalDistance、Alignment、AllowAutoFit、AllowCellSpacing、AllowOverlap，以及另外 38 项。

属性

名称	类型	访问	描述
`NodeType`	`NodeType`	读取	返回 Table。
`FirstRow`	`Row`	读取	返回 Table 中的第一个 Row 节点。
`LastRow`	`Row`	读取	返回表格中的最后一个 Row 节点。
`Rows`	`RowCollection`	读取	提供对表格行的类型化访问。
`Alignment`	`TableAlignment`	读写	指定内联表格在文档中的对齐方式。
`AllowAutoFit`	`bool`	读写	允许 Microsoft Word 和 Aspose.Words 自动调整表格中的单元格大小以适应其内容。
`PreferredWidth`	`PreferredWidth`	读写	获取或设置表格首选宽度。
`Bidi`	`bool`	读写	获取或设置此表是否为从右到左的表。
`LeftPadding`	`double`	读写	获取或设置要在单元格内容左侧添加的空间量（以点为单位）。
`RightPadding`	`double`	读写	获取或设置要在单元格内容右侧添加的空间量（以点为单位）。
`TopPadding`	`double`	读写	获取或设置要在单元格内容上方添加的空间量（以点为单位）。
`BottomPadding`	`double`	读写	获取或设置在单元格内容下方添加的空间量（以点为单位）。
`CellSpacing`	`double`	读写	获取或设置单元格之间的空间量（以点为单位）。
`AllowCellSpacing`	`bool`	读写	获取或设置 “Allow spacing between cells” 选项。
`LeftIndent`	`double`	读写	获取或设置表示表格左缩进的值。
`StyleOptions`	`TableStyleOptions`	读写	获取或设置指定表格样式如何应用于此表格的位标志。
`Style`	`Style`	读写	获取或设置应用于此表的表样式。
`StyleName`	`string`	读写	获取或设置应用于此表的表格样式名称。
`StyleIdentifier`	`StyleIdentifier`	读写	获取或设置应用于此表的表样式的与区域无关的样式标识符。
`TextWrapping`	`TextWrapping`	读写	获取或设置表的 TextWrapping。
`Title`	`string`	读写	获取或设置此表的标题。
`Description`	`string`	读写	获取或设置此表的描述。
`DistanceLeft`	`double`	读写	获取或设置表格左侧与周围文本之间的距离（单位为点）。
`DistanceRight`	`double`	读写	获取或设置表格右侧与周围文本之间的距离（单位为点）。
`DistanceTop`	`double`	读写	获取或设置表格顶部与周围文本之间的距离（以点为单位）。
`DistanceBottom`	`double`	读写	获取或设置表格底部与周围文本之间的距离（以点为单位）。
`RelativeHorizontalAlignment`	`HorizontalAlignment`	读写	获取或设置浮动表格的相对水平对齐方式。
`RelativeVerticalAlignment`	`VerticalAlignment`	读写	获取或设置浮动表格的相对垂直对齐方式。
`HorizontalAnchor`	`RelativeHorizontalPosition`	读写	获取用于计算浮动表水平定位的基对象。
`VerticalAnchor`	`RelativeVerticalPosition`	读写	获取用于计算浮动表垂直定位的基对象。
`AbsoluteHorizontalDistance`	`double`	读写	获取或设置由表属性指定的绝对水平浮动表格位置，以点为单位。
`AbsoluteVerticalDistance`	`double`	读写	获取或设置由表属性指定的绝对垂直浮动表格位置，以点为单位。
`AllowOverlap`	`bool`	读取	获取浮动表格在显示时是否允许文档中的其他浮动对象重叠其范围。
`IsComposite`	`bool`	读取	返回 true，因为此节点可以拥有子节点。
`HasChildNodes`	`bool`	读取	如果此节点有任何子节点，则返回 true。
`FirstChild`	`Node`	读取	获取该节点的第一个子节点。
`LastChild`	`Node`	读取	获取节点的最后一个子节点。
`Count`	`int`	读取	获取此节点的直接子节点数量。
`ParentNode`	`CompositeNode`	读取	获取此节点的直接父节点。
`Document`	`DocumentBase`	读取	获取此节点所属的文档。
`PreviousSibling`	`Node`	读取	获取紧接在此节点之前的节点。
`NextSibling`	`Node`	读取	获取紧接在此节点之后的节点。
`Range`	`Range`	读取	返回一个 Range 对象，表示此节点中包含的文档部分。
`CustomNodeId`	`int`	读写	指定自定义节点标识符。

方法

签名	描述
`Table(doc: DocumentBase)`	初始化 Table 类的新实例。
`ConvertToHorizontallyMergedCells()`	将按宽度水平合并的单元格转换为按 HorizontalMerge 合并的单元格。
`Accept(visitor: DocumentVisitor)`	调用 VisitTableStart，然后对该节的所有子节点调用 Accept，并在最后调用 VisitTableEnd。
`AcceptStart(visitor: DocumentVisitor)`	接受访问者以访问表的起始位置。
`AcceptEnd(visitor: DocumentVisitor)`	接受访问者以访问表格的末尾。
`EnsureMinimum()`	如果表格没有行，则创建并追加一个 Row。
`SetBorders(lineStyle: LineStyle, lineWidth: double, color: Color)`	将所有表格边框设置为指定的线条样式、宽度和颜色。
`SetBorder(borderType: BorderType, lineStyle: LineStyle, lineWidth: double, color: Color, isOverrideCellBorders: bool)`	将指定的表格边框设置为指定的线条样式、宽度和颜色。
`ClearBorders()`	删除此表格的所有表格和单元格边框。
`SetShading(texture: TextureIndex, foregroundColor: Color, backgroundColor: Color)`	在整个表格上将阴影设置为指定的值。
`ClearShading()`	删除表格的所有底纹。
`AutoFit(behavior: AutoFitBehavior)`	根据指定的自动适应行为调整表格和单元格的大小。
`GetText()`	获取此节点及其所有子节点的文本。
`GetChildNodes(nodeType: NodeType, isDeep: bool)`	返回匹配指定类型的子节点集合。
`GetChild(nodeType: NodeType, index: int, isDeep: bool)`	返回匹配指定类型的第 N 个子节点。
`SelectNodes(xpath: string)`	选择匹配 XPath 表达式的节点列表。
`SelectSingleNode(xpath: string)`	选择匹配 XPath 表达式的第一个节点。
`GetEnumerator()`	提供对该节点子节点的 for each 风格迭代的支持。
`AppendChild(newChild: T)`	将指定节点添加到该节点的子节点列表的末尾。
`PrependChild(newChild: T)`	将指定节点添加到该节点的子节点列表的开头。
`InsertAfter(newChild: T, refChild: Node)`	在指定的参考节点之后立即插入指定节点。
`InsertBefore(newChild: T, refChild: Node)`	在指定的参考节点之前立即插入指定节点。
`RemoveChild(oldChild: T)`	删除指定的子节点。
`RemoveAllChildren()`	删除当前节点的所有子节点。
`RemoveSmartTags()`	删除当前节点的所有 SmartTag 后代节点。
`IndexOf(child: Node)`	返回指定子节点在子节点数组中的索引。
`CreateNavigator()`	创建可用于遍历和读取节点的导航器。
`Clone(isCloneChildren: bool)`	当节点克隆是另一个（通常是复合）节点克隆过程的一部分时，您应使用 Clone(bool, INodeCloningListener) 重载。
`GetAncestor(ancestorType: Type)`	获取指定对象类型的第一个祖先。
`GetAncestorOf()`	在此 Table 实例上调用 GetAncestorOf。
`Remove()`	从父节点中移除自身。
`NextPreOrder(rootNode: Node)`	根据前序树遍历算法获取下一个节点。
`PreviousPreOrder(rootNode: Node)`	根据前序树遍历算法获取上一个节点。
`ToString(saveFormat: SaveFormat)`	将节点的内容导出为指定格式的字符串。
`NodeTypeToString(nodeType: NodeType)`	一个将节点类型枚举值转换为用户友好字符串的实用方法。

另请参阅

Aspose.Words for .NET — Enterprise API Reference