addHTML

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

将 HTML 字符串追加到文档

全页展开

语法

htmlObjOut = addHTML(documentObj,htmlText)

说明

htmlObjOut = addHTML(documentObj,htmlText) 将一串 HTML 文本转换为一组 DOM 对象，并将该组追加到 Document 对象 documentObj。

输入参数

全部展开

`documentObj` — 要追加内容的文档
`mlreportgen.dom.Document` 对象

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

`htmlText` — HTML 文本
字符向量

HTML 文本，指定为字符向量。

示例: 'Hello World'

输出参量

全部展开

`htmlObjOut` — 带有追加内容的 HTML 对象
`mlreportgen.dom.HTML` 对象

带有追加内容的 HTML 对象，作为 mlreportgen.dom.HTML 对象返回。

示例

全部展开

将 HTML 文本追加到文档

从 HTML 文本创建一个 HTML 对象以用于 Microsoft^® Word 报告。

import mlreportgen.dom.*;
rpt = Document('HTMLToWordReport','docx');     
htmlObj = addHTML(rpt,...
    '<p><b>Hello</b> <i style="color:green">World</i></p>');

生成 Word 报告。

close(rpt);
rptview(rpt.OutputPath);

提示

MATLAB^® Report Generator™ mlreportgen.dom.HTML 或 mlreportgen.dom.HTMLFile 对象通常无法接受将原生文档导出为 HTML 标记的第三方应用程序（例如 Microsoft Word）的原始 HTML 输出。在这些情况下，您的报告 API 报告生成程序可以使用 mlreportgen.utils.html2dom.prepHTMLString 和 mlreportgen.utils.html2dom.prepHTMLFile 函数准备原始 HTML 以供 mlreportgen.dom.HTML 或 mlreportgen.dom.HTMLFile 对象使用。通常，您的程序必须进一步处理准备好的 HTML 以删除有效但不想要的对象，例如原始内容中的换行符。
默认情况下，DOM API 使用 12 点的基本字体大小将 em 单位转换为实际字体大小。例如，指定为 2em 的字体大小将转换为 24 点。要指定不同的基本字体大小，请使用 mlreportgen.dom.HTML 对象将内容添加到报告中。将对象的 EMBaseFontSize 属性设置为基本字体大小。例如，如果将 EMBaseFontSize 属性设置为 14，则字体大小 2em 将转换为 28 点。