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

mlreportgen.dom.RepeatAsHeaderRow 类

命名空间: mlreportgen.dom

重复表行

全页展开

描述

使用 mlreportgen.dom.RepeatAsHeaderRow 类的对象来指定当表跨越多页时，表行是否在每一页上重复。您只能将此对象与 Microsoft® Word 文档一起使用。

注意

您可以将此对象用于表的第一行以及任何紧接着的行。如果某一行未设置为跨页重复，则连续的行也不能设置为跨页重复。如果将此对象应用于非重复行之后的行，则会忽略该对象。

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

创建对象

描述

repeatAsHeaderRowObj = RepeatAsHeaderRow 创建一个 mlreportgen.dom.RepeatAsHeaderRow 对象并将 Value 属性设置为 true。

repeatAsHeaderRowObj = RepeatAsHeaderRow(value) 创建一个 mlreportgen.dom.RepeatAsHeaderRow 对象并将 Value 属性设置为 value。

示例

属性

全部展开

目标标识符，指定为字符向量或字符串标量。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

表行是否在每一页上重复，指定为数值或逻辑值 1 (true) 或 0 (false)，其中：

  • true 或 1 - 当表跨越多页时，表行会在每个新页面上重复。

  • false 或 0 - 表行不重复。

数据类型: logical

示例

全部折叠

创建一个 docx 类型的 mlreportgen.dom.Document。

import mlreportgen.dom.*;
document = Document("Repeat_Rows_Doc","docx");

创建一个具有一列和 30 行 mlreportgen.dom.Table 对象的 mlreportgen.dom.Text，然后设置表行的文本。

append(document,"Table 1:");
table1 = Table(arrayfun(@(x) Text(),ones(30,1)));
table1.entry(1,1).Children(1).Content = "Header 1, does not repeat across pages";
table1.entry(2,1).Children(1).Content = "Header 2, does not repeat across pages";
for rowInd = 3:30
  table1.entry(rowInd,1).Children(1).Content = sprintf("Row %i of Table 1",rowInd);
end

设置表边框和分隔符的样式，然后将表追加到文档。

table1.Style = [table1.Style,{Border("solid"),RowSep("solid")}];
append(document,table1);

创建第二个表，其中包含一列和 30 行 Text 对象，然后设置表行的文本。

append(document,LineBreak());
append(document,LineBreak());
append(document,"Table 2:");
table2 = Table(arrayfun(@(x) Text(),ones(30,1)));
table2.entry(1,1).Children(1).Content = "Header 1, repeats across pages";
table2.entry(2,1).Children(1).Content = "Header 2, repeats across pages";
for rowInd = 3:30
  table2.entry(rowInd,1).Children(1).Content = sprintf("Row %i of Table 2",rowInd);
end

将表的前两行设置为跨页重复。然后设置表边框和分隔符的样式，并将表追加到文档。

table2.row(1).Style = [table2.row(1).Style,{RepeatAsHeaderRow(true)}];
table2.row(2).Style = [table2.row(2).Style,{RepeatAsHeaderRow(true)}];
table2.Style = [table2.Style,{Border("solid"),RowSep("solid")}];
append(document,table2);

关闭生成报告的文档，然后打开报告。

close(document);
rptview(document);

版本历史记录

在 R2014b 中推出

另请参阅

|

主题