Main Content

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

mlreportgen.dom.LOT 类

命名空间: mlreportgen.dom
超类: mlreportgen.dom.LOC

表格列表

自 R2020b 起

全页展开

描述

使用 mlreportgen.dom.LOT 类的对象在报告中创建表列表。

每个列表项包含表格的标题和指向报告中标题的链接。在 PDF 或 Microsoft® Word 报 告中，列表项还包括页码以及填充标题和页码之间空格的引导符。在 PDF 或 Word 报 告中，列表位于报告中追加 LOT 对象的位置。在 HTML 报 告中，该列表位于侧边栏，标题为 List of Tables。

列表的生成方式取决于报告类型。

  • PDF - DOM API 在报告生成期间生成列表。

  • Word - DOM API 为列表生成一个占位符。要生成列表项，您必须在报告生成程序或 Word 中更新 Word 文档。请参阅更新 Word 文档中的目录和生成的列表。

  • HTML - DOM API 为列表生成占位符。当报告在 HTML 浏览器中打开时，浏览器会生成列表。

要将表格包含在表列表中：

  1. 使用 mlreportgen.dom.Paragraph 对象为表格创建标题。

  2. 使用 mlreportgen.dom.AutoNumber 对象将 Paragraph 对象与名为 table 的编号流关联。

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

类属性

ConstructOnLoad
true
HandleCompatible
true

有关类属性的信息，请参阅类属性。

创建对象

描述

示例

LOTObj = mlreportgen.dom.LOT() 创建一个 mlreportgen.dom.LOT 对象并将 LeaderPattern 属性设置为 '.'。

LOTObj = mlreportgen.dom.LOT(leaderPattern) 创建一个 mlreportgen.dom.LOT 对象，并将 LeaderPattern 属性设置为指定的引导符模式。

属性

全部展开

编号流的名称，指定为 'table'。请勿更改此属性的值。要使用自定义编号流名称创建题注或标题列表，请使用 mlreportgen.dom.LOC 对象。

标题和页码之间使用的引导符类型，指定为以下字符向量或字符串标量之一：

  • '.' 或 'dots'

  • ' ' 或 'space'

此属性仅适用于 PDF 报 告。Word 报告总是以点为引导符。HTML 报 告没有引导符。

样式名称，指定为字符向量或字符串标量。样式名称是此元素所追加到的文档或文档部件的样式表中指定的样式的名称。指定的样式定义了此元素在输出文档中的外观，除非由此元素的 Style 属性指定的格式覆盖。要了解有关使用样式表的更多信息，请参阅 使用样式表样式。

注意

Microsoft Word 输 出忽略样式名称。

属性：

NonCopyable
true

数据类型: char | string

此文档元素对象的格式规范，指定为格式对象数组。此属性指定的格式将覆盖此元素的 StyleName 属性指定的相应格式。不适用于此元素的格式将被忽略。

属性：

NonCopyable
true

数据类型: cell

此文档元素的自定义属性，指定为 mlreportgen.dom.CustomAttribute 对象的数组。自定义属性必须被此对象所追加到的文档元素的输出格式支持。

属性：

NonCopyable
true

mlreportgen.dom.LOT 对象的父级，指定为文档元素对象。一个文档元素必须只有一个父元素。

属性：

SetAccess
private
NonCopyable
true

mlreportgen.dom.LOT 对象的子项，指定为文档元素对象的数组。此属性包含使用 append 方法追加的文档元素对象。

属性：

SetAccess
private
NonCopyable
true

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

属性：

NonCopyable
true

数据类型: char | string

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

属性：

NonCopyable
true

数据类型: char | string

方法

全部展开

示例

全部折叠

打开实时脚本

创建一个表列表作为 mlreportgen.dom.LOT 对象。要将表包含在列表中：

  • 将表的标题创建为 mlreportgen.dom.Paragraph 对象。

  • 将 Paragraph 对象与名为 table 的编号流关联。

导入 DOM 命名空间，这样您就不必使用长而完全限定的类名。

import mlreportgen.dom.*

创建报告。

d = Document("DOM Report with List of Tables","docx");

创建表格容器列表并将其追加到报告中。

lotObj = LOT();
append(d,lotObj);
append(d,PageBreak);

创建一个表。

t1 = Table(magic(2));

为表格标题创建一个段落。 

p1 = Paragraph("Table ");

创建一个名为 table 的自动编号流并将其与段落关联。 

append(p1,AutoNumber("table"));

增加编号流的计数器。

p1.Style = {CounterInc("table"),WhiteSpace("preserve")};

将标题文本的其余部分追加到段落并将段落追加到报告中。

append(p1,".");
append(p1," Order 2 Magic Square");
append(d,p1);

将表格追加到报告的表格标题后。

append(d,t1);

创建另一个表格并为该表格添加标题。将 table 编号流与表标题关联并增加编号计数器。 

t2 = Table(magic(3));
p2 = Paragraph("Table ");
append(p2,AutoNumber("table"));
p2.Style = {CounterInc("table"),WhiteSpace("preserve")};

将标题文本的其余部分追加到段落并将段落追加到报告中。

append(p2,".");
append(p2, " Order 3 Magic Square");
append(d,p2);

将表格追加到报告的表格标题后。

append(d,t2);

关闭并查看报告。

close(d);
rptview(d);

以下是生成的报告中的表列表：

版本历史记录

在 R2020b 中推出

另请参阅

| | | |

主题