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

append

类: mlreportgen.dom.Document
命名空间: mlreportgen.dom

将 DOM 或 MATLAB 对象追加到文档

全页展开

语法

domObjOut = append(docObj,textContent)
domObjOut = append(docObj,listContent)
domObjOut = append(docObj,tableContent)
domObjOut = append(docObj,paraObj,pageLayoutObj)
domObjOut = append(___,styleName)
domObjOut = append(docObj,domObj)

说明

domObjOut = append(docObj,textContent) 将文本或数字追加到文档并返回文本对象。在 Microsoft® Word 和 PDF 输出中，文本被包装在段落中，因为 Word 和 PDF 不允许将未包装的文本添加到文档正文中。在 HTML 输出中，文本不会换行到段落中。

domObjOut = append(docObj,listContent) 追加一个无序列表并返回一个无序列表对象。

示例

domObjOut = append(docObj,tableContent) 追加一个表并返回一个表对象。

示例

domObjOut = append(docObj,paraObj,pageLayoutObj) 追加一个段落，开始一个新的页面布局部分，其属性由 pageLayoutObject 指定，并返回一个段落对象。

domObjOut = append(___,styleName) 使用指定的样式追加指定的内容。

示例

domObjOut = append(docObj,domObj) 将 DOM 对象追加到文档并返回该对象。

示例

输入参数

全部展开

要追加内容的文档，指定为 mlreportgen.dom.Document 对象。

要追加到文档的文本，指定为字符向量或字符串标量。文本对象包装在段落对象中，并将段落追加到文档中。文本被包装在段落中以与 Microsoft Word 保持一致，后者不允许将文本添加到文档正文中。对于 HTML，文本换行可能会导致意外行为。

要追加到文档的列表对象，指定为有序列表、无序列表或数组。如果输入是双精度值或字符串的 1D 水平数组，或 1D 分类数组，则会创建一个无序列表对象，并将该列表对象追加到文档中。

要追加到文档的表对象，指定为以下之一：

  • 二维双精度值数组 - 追加并返回 Table 对象

  • 二维字符串数组 - 追加并返回 Table 对象

  • 二维分类数组 - 追加并返回 Table 对象

  • 表头的字符串元胞数组和表体的数字、单元格或分类数组- 追加并返回 FormalTable 对象

  • MATLAB 表 - 追加并返回 MATLABTable 对象

要追加到文档的段落，指定为段落对象。它还启动一个新的页面布局部分，其属性由 pageLayoutObj 输入指定。

应用于追加页面布局部分的页面布局，指定为 PageLayout 对象。

应用于文本、表或列表输入的样式。

输出参量

全部展开

返回追加的对象。对象的类型取决于第二种输入类型。

示例

全部展开

打开实时脚本

创建一个 OrderedList 对象并将其追加到报告中。 

import mlreportgen.dom.*;
d = Document('mydoc','html');

ol = OrderedList({'first step' 'second step' 'last step'});
append(d,ol);

close(d);
rptview('mydoc','html');

对文本使用 Word Title 样式。

import mlreportgen.dom.*;
d = Document("mydoc","docx");
append(d,"This Is a Title","Title");
close(d);
rptview("mydoc","docx");

从工作区变量中创建一个名为 patients 的 MATLAB® 表。

load patients;
BloodPreasure = [Systolic Diastolic];
patients = table(Gender,Age,Smoker,BloodPreasure);
patients.Properties.RowNames = LastName;

根据 Age 变量对表进行排序。

load patients;
BloodPreasure = [Systolic Diastolic];
patients = table(Gender,Age,Smoker,BloodPreasure);
patients.Properties.RowNames = LastName;

根据 Age 变量对表进行排序。

sorted = sortrows(patients,"Age");

使用已排序的患者表创建 PDF 报告。

rpt = mlreportgen.dom.Document("MyFileName","pdf");
append(rpt,sorted);
close(rpt);

在查看器中显示 PDF 报告。

rptview(rpt.OutputPath)
打开实时脚本
import mlreportgen.dom.*;
d = Document('mydoc');
table = append(d,{'row 1 - col 1' 'row 1 - col 2';...
    'row 2 - col 1' 'row 2 - col 2'});
table.Style = {Border('double'),ColSep('solid'),RowSep('solid')};
close(d);
rptview('mydoc','html');

提示

版本历史记录

在 R2014b 中推出

另请参阅

类

主题