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

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) 将文本或数值 (textContent) 追加到文档 (docObj) 中，并返回一个文本对象。在 Microsoft® Word 和 PDF 输出中，文本被包装在段落中，因为 Word 和 PDF 不允许将未包装的文本添加到文档正文中。在 HTML 输出中，文本不会换行到段落中。

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

domObjOut = append(docObj,tableContent) 向表中追加数据，生成表 tableContent，并返回一个表对象。

示例

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

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

示例

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

示例

输入参数

全部展开

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

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

要追加到文档中的列表对象，应指定为以下选项之一：

  • mlreportgen.dom.OrderedList 对象

  • mlreportgen.dom.UnorderedList 对象

  • 一维双精度值或字符串水平数组 - 追加并返回 mlreportgen.dom.UnorderedList 对象

  • 1D 分类数组 - 追加数据并返回一个 mlreportgen.dom.UnorderedList 对象

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

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

要应用于追加页面布局部分的页面布局，指定为 mlreportgen.dom.DOCXPageLayout 或 mlreportgen.dom.PDFPageLayout 对象。

要应用于文本、表或列表输入的样式，指定为字符向量或字符串标量。

输出参量

全部展开

追加的文档元素，其返回的 DOM 对象类型与输入对象相同。

示例

全部展开

打开实时脚本

创建一个 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 中推出

另请参阅

类

主题