主要内容

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

mlreportgen.dom.TableRow 类

R2026a

命名空间: mlreportgen.dom

描述

使用 mlreportgen.dom.TableRow 类的实例创建一张表中的一行。

要了解可以将 mlreportgen.dom.TableRow 对象追加到哪些 DOM 对象,请参阅将 mlreportgen.dom.TableRow 对象追加到 DOM 类对象上。

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

类属性

ConstructOnLoad
true
HandleCompatible
true

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

创建对象

描述

tableRowObj = TableRow 创建一个空表行。

示例

属性

全部展开

表行的高度,指定为字符向量或字符串标量,其中包含一个数字,后跟一个计量单位的缩写。例如,"0.5in" 指定半英寸。有效的缩写是:

  • "px" - 像素

  • "cm" - 厘米

  • "in" - 英寸

  • "mm" - 毫米

  • "pc" - 派卡

  • "pt" - 磅

您也可以通过省略单位来指定像素值。例如,"5" 指定 5 像素。

如果此表行的 Style 属性包含 mlreportgen.dom.RowHeight 格式对象,则 Height 属性将设置为格式对象指定的高度。

如果将 Height 属性设置为高度值,则会创建具有指定高度的 RowHeight 对象,并将其添加到行的 Style 属性中,或者用于替换 Style 属性中现有的 RowHeight 对象。新的 RowHeight 对象的 Type 是 "exact"。此 Type 值导致 Microsoft® Word 生成一行指定高度的内容并截断不适合的内容。HTML 和 PDF 查看器会创建至少具有指定高度的行,并调整行高以适应内容。

注意

如果将 mlreportgen.dom.Height 对象添加到 Style 属性,它将转换为 mlreportgen.dom.RowHeight 对象,并且 Type 设置为 "atleast"。此 Type 值导致 HTML 和 PDF 查看器以及 Microsoft Word 创建至少具有指定高度的行,并调整行高以适应内容。

示例: "0.5in"

此行中的表条目,指定为 mlreportgen.dom.TableEntry 对象的数组。使用此属性可以访问此行中的表条目。例如,此代码访问第 2 行中的元素 2:

t = Table({"e11", "e12"; "e21", "e22"});
elem22 = t.row(2).Entries(2);

您还可以使用 mlreportgen.dom.Table 类的 entry 方法访问第 2 行中的元素 2。例如:

t = Table({"e11", "e12"; "e21", "e22"});
elem22 = entry(t,2,2);

一旦访问与表条目相对应的 TableEntry 对象,就可以通过设置该对象的属性来格式化该条目。请参阅格式化表条目。

此属性是只读的。

此行中的表条目数,指定为整数。此属性是只读的。

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

注意

Microsoft Word 报告会忽略文档模板中未定义的样式名称。有关 Microsoft Word 模板的详细信息,请参阅DOM API 报告程序模板。

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

表行样式,指定为由 DOM 格式化对象组成的元胞数组。这些格式将覆盖由 StyleName 属性指定的样式表样式定义的相应格式。

您可以通过向 Style 属性添加 mlreportgen.dom.RowHeight 或 mlreportgen.dom.Height 对象来指定行高。mlreportgen.dom.Height 对象转换为 mlreportgen.dom.RowHeight 对象,其类型设置为 "atleast"。

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: cell

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

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

此对象的父对象,指定为文档元素对象。一个文档元素必须只有一个父元素。

属性:

GetAccess
public
SetAccess
private
NonCopyable
true

此对象的子对象,指定为文档元素对象数组。此属性包含使用 append 方法追加的文档元素对象。

属性:

GetAccess
public
SetAccess
private
NonCopyable
true

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

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

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

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

方法

全部展开

示例

全部折叠

要向空表添加内容,请将表条目追加到表行,然后将表行追加到表。此示例创建以下 2×2 表:

创建一个文档,然后创建一个包含两列的表。

import mlreportgen.dom.*

d = Document();
t = Table(2);

创建两行表。

tr1 = TableRow();
tr2 = TableRow();

创建包含内容的表条目并将表条目追加到行。

append(tr1,TableEntry('e11'));
append(tr1,TableEntry('e12'));
append(tr2,TableEntry('e21'));
append(tr2,TableEntry('e22'));

将表行追加到表中。

append(t,tr1);
append(t,tr2);

将表追加到文档。关闭并查看文档。

append(d,t);
close(d);
rptview(d);

使用 Entries 对象的 mlreportgen.dom.TableRow 属性来访问与要格式化的条目相对应的 mlreportgen.dom.TableEntry 对象。通过设置 TableEntry 对象的格式属性或通过将格式对象添加到对象的 Style 属性来格式化条目。此示例将第二行第二个条目的文本颜色更改为红色。

import mlreportgen.dom.*
d = Document();
t = Table({'e11','e12';'e21','e22'});
t.row(2).Entries(2).Style = {Color('red')};
append(d,t);
close(d);
rptview(d);
    

在结果表中,第二行第二个条目中的文本 e22 为红色。

或者,您可以使用包含该条目的 entry 对象的 mlreportgen.dom.Table 方法来访问表条目。在上面的示例中,替换:

t.row(2).Entries(2).Style = {Color('red')};

为:

elem = entry(t,2,2);
elem.Style = {Color('red')};

创建一个两列表。

import mlreportgen.dom.*;
myReport = Document('myDoc','html');
table = Table(2);
table.Style = {Border('solid'),RowSep('solid'),ColSep('solid')};
table.TableEntriesStyle = {Width('2in'),HAlign('center')};

创建带有条目的三个表行。使用 append(row,te) 将每个条目追加到一行。

for i=1:3
    row = TableRow();
    te = TableEntry();
    append(te,Text([num2str(i) ' - 1']));
    append(row,te);
    te = TableEntry();
    append(te,Text([num2str(i) ' - 2']));
    append(row,te);
    append(table,row);
end

追加表并显示报告。

append(myReport,table);

close(myReport);
rptview(myReport.OutputPath);

详细信息

全部展开

提示

  • 为避免表格式错误,请确保表行所占的元胞数量始终相同,无论表中有多少表条目。例如,该表的第一行包含两个表条目。第一个条目 Winter 横跨两列,第二个条目 Spring 横跨一列。第二行有三个条目,每个条目各占一列。

    Table with two rows that have different numbers of cells but span the same number of columns.

    如果您只修改表的第二行,使前两个表条目 Jaunary 和 February 各占两列,而最后一个表条目占一列,那么表的格式就会发生变化。

    The first row in the table has two entries. The second row has three entries and the last entry spans two rows.

版本历史记录

在 R2014b 中推出