iTextRow 接口 (tom.h)

ITextRow 接口提供插入一个或多个相同的表行以及检索和更改表行属性的方法。 若要插入非典型行，请为每个不同的行配置调用 ITextRow：：Insert 。

继承

ITextRow 接口继承自 IDispatch 接口。 ITextRow 还具有以下类型的成员：

方法

ITextRow 接口具有这些方法。

ITextRow：：Apply 将此文本行对象的格式设置属性应用于关联的 ITextRange2 中的指定行。
ITextRow：：CanChange 确定是否可对此行进行更改。
ITextRow：：GetAlignment 获取行的水平对齐方式。
ITextRow：：GetCellAlignment 获取活动单元格的垂直对齐方式。
ITextRow：：GetCellBorderColors 获取活动单元格的边框颜色。
ITextRow：：GetCellBorderWidths 获取活动单元格的边框宽度。
ITextRow：：GetCellColorBack 获取活动单元格的背景色。
ITextRow：：GetCellColorFore 获取活动单元格的前景色。
ITextRow：：GetCellCount 获取此行中的单元格计数。
ITextRow：：GetCellCountCache 获取为此行缓存的单元格计数。
ITextRow：：GetCellIndex 获取要获取或设置其参数的活动单元格的索引。
ITextRow：：GetCellMargin 获取此行的单元格边距。
ITextRow：：GetCellMergeFlags 获取活动单元格的合并标志。
ITextRow：：GetCellShading 获取活动单元格的底纹。
ITextRow：：GetCellVerticalText 获取活动单元格的垂直文本设置。
ITextRow：：GetCellWidth 获取活动单元格的宽度。
ITextRow：：GetHeight 获取行的高度。
ITextRow：：GetIndent 获取此行的缩进。
ITextRow：：GetKeepTogether 获取是否允许跨页拆分此行。
ITextRow：：GetKeepWithNext 获取此行是否应与它后面的行出现在同一页上。
ITextRow：：GetNestLevel 获取表的嵌套级别。
ITextRow：：GetProperty 获取指定属性的值。 (ITextRow.GetProperty)
ITextRow：：GetRTL 获取此行是否具有从右到左的方向。
ITextRow：：Insert 在关联的 ITextRange2 对象标识的位置插入行或行。
ITextRow：：Isequal 比较两个表行以确定它们是否具有相同的属性。
ITextRow：：Reset 重置行。
ITextRow：：SetAlignment 设置行的水平对齐方式。
ITextRow：：SetCellAlignment 设置活动单元格的垂直对齐方式。
ITextRow：：SetCellBorderColors 设置活动单元格的边框颜色。
ITextRow：：SetCellBorderWidths 设置活动单元格的边框宽度。
ITextRow：：SetCellColorBack 设置活动单元格的背景色。
ITextRow：：SetCellColorFore 设置活动单元格的前景色。
ITextRow：：SetCellCount 设置行中的单元格计数。
ITextRow：：SetCellCountCache 设置为行缓存的单元格计数。
ITextRow：：SetCellIndex 设置活动单元格的索引。
ITextRow：：SetCellMargin 设置行的单元格边距。
ITextRow：：SetCellMergeFlags 设置活动单元格的合并标志。
ITextRow：：SetCellShading 设置活动单元格的底纹。
ITextRow：：SetCellVerticalText 设置活动单元格的垂直文本设置。
ITextRow：：SetCellWidth 以缇为单位设置活动单元格宽度。
ITextRow：：SetHeight 设置行的高度。
ITextRow：：SetIndent 设置行的缩进。
ITextRow：：SetKeepTogether 设置是否允许跨页拆分此行。
ITextRow：：SetKeepWithNext 设置某一行是否应与它后面的行出现在同一页上。
ITextRow：：SetProperty 设置指定属性的值。 (ITextRow.SetProperty)
ITextRow：：SetRTL 设置此行是否具有从右到左的方向。

注解

若要选择表格、行或单元格，请使用 ITextRange：：Expand，并将 Unit 参数分别设置为 tomTable、 tomRow 或 tomCell。 这些单元还可以与 ITextRange：：Move 方法一起使用，以便导航和选择多个行或单元格。

某些 ITextRow 属性适用于整行，例如行对齐方式。 此外，还有许多属性（如单元格对齐方式）适用于通过 ITextRow：：SetCellIndex 方法设置索引的单元格。 此单元格称为活动单元格。

ITextRow 的工作方式与 ITextPara2 类似，但在调用 ITextRow：：Apply 或 ITextRow：：Insert 方法之前不会修改文档。 此外，行和单元格参数始终处于活动状态，也就是说，它们不能具有 tomDefault 值。

初始化时， ITextRow 对象在关联的 ITextRange2 的活动端获取表行属性（如果有）。 ITextRow：：Reset 方法可用于将这些属性更新为 ITextRange2 对象的当前值。

Rich Edit 控件表由一系列表行组成，而表行又包含段落序列。 表格行以特殊的双字符分隔符段落 U+FFF9 U+000D 开头，以双字符分隔符段落 U+FFFB U+000D 结束。 每个单元格都以单元格标记 U+0007 结尾，该标记被视为硬段落尾标记，就像 U+000D (CR) 一样。 表格行和单元格参数被视为表格行分隔符的特殊段落格式。 单元格参数存储在选项卡数组的扩展版本中。 此格式允许将表嵌套在其他表中，并允许深入到 15 个级别。

体系结构非常灵活，每一个表行都可以具有任何有效的表行参数，而不考虑其他行的参数 (除了垂直合并标志) 。 例如，单元格数和表格行的起始缩进数可能不同，这与 HTML 中不同，HTML 采用 n×m 矩形格式，所有行都以相同的缩进开始。

另一方面，没有任何正式表说明存储在任何位置。 必须通过浏览表来找出行数等信息。 例如，可以通过调用 ITextRange：：StartOf (tomTable、tomFalse、NULL) 移动到当前表的开头，然后调用 ITextRange：：Move (tomRow、tomForward&dcRow) 来获取表中的行计数。 然后， dcRow + 1&数量包含表中的行数，因为按 tomRow 增量移动不会超出最后一个表行。

要求

要求	值
最低受支持的客户端	Windows 8 [仅限桌面应用]
最低受支持的服务器	Windows Server 2012 [仅限桌面应用]
目标平台	Windows
标头	tom.h