mlreportgen.dom.RowHeight 类

命名空间: mlreportgen.dom

表行高

描述

指定表行的高度。

此格式对象使您能够在 Microsoft^® Word 输出中指定精确（固定）的行高。如果行内容不适合指定的高度，Word 将截断内容以保留指定的高度。对于 PDF 和 HTML 输出，mlreportgen.dom.RowHeight 格式对象的行为与 mlreportgen.dom.Height 格式对象的行为相同。对于这两种格式的对象，PDF 和 HTML 文档都将指定的高度视为最小值，并向上调整以容纳内容。如果不需要指定精确的高度，您可以使用 RowHeight 或 Height 来指定高度。

mlreportgen.dom.RowHeight 类是一个 handle 类。

创建对象

描述

rowHeightObj = RowHeight 指定一行，高度正好是一英寸。

rowHeightObj = RowHeight(height) 将行设置为指定的高度。

示例

rowHeightObj = RowHeight(height,heightType) 将行设置为精确指定的高度或至少为指定的高度，具体取决于 heightType 的值。

属性

全部展开

`Id` — `mlreportgen.dom.RowHeight` 对象的标识符
字符向量 | 字符串标量

mlreportgen.dom.RowHeight 对象的对象标识符，指定为字符向量或字符串标量。DOM API 在创建文档元素对象时会生成一个会话唯一标识符。您可以为 Id 指定自己的值。

属性：

NonCopyable true

数据类型: char | string

`Tag` — `mlreportgen.dom.RowHeight` 对象的标签
字符向量 | 字符串标量

mlreportgen.dom.RowHeight 对象的标签，指定为字符向量或字符串标量。DOM API 在创建此对象的过程中生成一个会话唯一标签。生成的标签形式为 CLASS:ID，其中 CLASS 是对象类，ID 是对象的 Id 属性的值。指定您自己的标签值，以帮助您确定在文档生成过程中出现问题时要查找的位置。

属性：

NonCopyable true

数据类型: char | string

`Type` — 行高类型
`'exact'` | `'atleast'`

行高测量类型，指定为以下值之一：

'exact' - Microsoft Word 生成一行指定高度的内容并截断不适合的内容。HTML 和 PDF 查看器会创建至少具有指定高度的行，并调整行高以适应内容。
'atleast - Word、HTML 和 PDF 查看器创建至少指定高度的行，并调整行高以适应内容

`Value` — 表行高
`'1in'` (默认)

表行的高度以 valueUnits 的形式出现，其中 Units 是单位的缩写。这些缩写是有效的：

"px" - 像素
"cm" - 厘米
"in" - 英寸
"mm" - 毫米
"pc" - 派卡
"pt" - 磅

示例

全部折叠

指定表行高

创建一个包含两行的表。第一行至少具有指定的高度，第二行具有固定的最大高度。

import mlreportgen.dom.*;
d = Document('myTableDoc','docx');

t = Table(2);
t.Style = {Border('solid'),RowSep('solid'),ColSep('solid')};
t.Width = '1in';
r1 = TableRow();
r1.Style = {RowHeight('.25in','atleast')};
append(r1,TableEntry(...
    'This row can expand beyond .25 inches'));
append(r1,TableEntry('x'));

r2 = TableRow();
r2.Style = {RowHeight('.25in','exact')};
append(r2,TableEntry...
    ('Truncated text because height is fixed'));
append(r2,TableEntry('x'));

append(t,r1);
append(t,r2);
append(d,t);

close(d);
rptview('myTableDoc','docx');