主要内容

本页采用了机器翻译。点击此处可查看最新英文版本。

mlreportgen.dom.RowHeight 类

命名空间: mlreportgen.dom

表行高

描述

指定表行的高度。

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

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

创建对象

描述

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

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

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

示例

属性

全部展开

目标标识符,指定为字符向量或字符串标量。DOM API 在创建文档元素对象时会生成一个会话唯一标识符。

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

标记,指定为字符向量或字符串标量。DOM API 在创建此对象的过程中生成一个会话唯一标记。生成的标记形式为 CLASS:ID,其中 CLASS 是对象类,ID 是对象的 Id 属性的值。使用此值来帮助确定在文档生成过程中出现的问题的位置。

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

行高测量类型,指定为以下值之一:

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

  • "atleast - Word、HTML 和 PDF 查看器创建至少指定高度的行,并调整行高以适应内容

表行的高度,指定为字符向量或字符串标量,其中包含一个数字,后跟一个测量单位的缩写。例如,"10px" 指定 10 像素。有效的缩写是:

  • "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");

版本历史记录

在 R2014b 中推出