mlreportgen.dom.TableRow 类
命名空间: mlreportgen.dom
表行
描述
创建对象
描述
创建一个空表行。tableRowObj
= TableRow
属性
此表行的高度,指定为字符向量或字符串标量,其中包含一个数字,后跟一个测量单位的缩写。例如,"0.5in"
指定半英寸。有效的缩写是:
"px"
- 像素"cm"
- 厘米"in"
- 英寸"mm"
- 毫米"pc"
- 派卡"pt"
- 磅
如果此表行的 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"
。
文档元素的自定义属性,指定为 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')};
版本历史记录
在 R2014b 中推出
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
选择网站
选择网站以获取翻译的可用内容,以及查看当地活动和优惠。根据您的位置,我们建议您选择:。
您也可以从以下列表中选择网站:
如何获得最佳网站性能
选择中国网站(中文或英文)以获得最佳网站性能。其他 MathWorks 国家/地区网站并未针对您所在位置的访问进行优化。
美洲
- América Latina (Español)
- Canada (English)
- United States (English)
欧洲
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)