报告格式化方法
您可以使用样式表、格式对象、格式属性或这些方法的组合来格式化报告。
模板中的样式表
DOM API 为每种输出类型都附带了默认模板,用于在生成报告时对其进行格式化。您可以自定义这些模板来指定报告的默认格式和布局。请参阅DOM API 报告程序模板。
使用模板中的样式表来描述文档对象(如段落、页眉和表格)的默认格式。样式表是格式样式的集合。样式是针对特定类型对象或(对于 HTML 和 PDF 而言)针对文档中特定上下文中出现的特定类型对象的命名格式集合。例如,您可以定义一个段落样式 MyPara
,它使用一组格式,如字体大小、强调和字体系列。您定义另一个名为 YourPara
的段落样式,该样式使用不同的格式集。当您编写报告程序时,您可以通过名称将样式分配给段落对象。相关示例,请参阅使用样式表样式。
格式化对象
格式对象是一个 MATLAB® 对象,它定义文档格式的属性和功能,例如字体系列或大小。DOM API 提供了一组构造函数,用于创建与 HTML、Word 和 PDF 文档中可用的大多数格式化选项相对应的格式对象。大多数 DOM 文档对象都包含一个 Style
属性,您可以将其设置为格式对象的元胞数组。您可以使用格式对象与文档对象 Style
属性来格式化对象。例如,此代码使用格式对象来指定警告段落的样式。
import mlreportgen.dom.* p = Paragraph('Danger!'); p.Style = {Color('red'),FontFamily('Arial'),FontSize('18pt')};
最佳做法是通过连接 Style
属性的现有值和要添加的格式对象的元胞数组来设置 Style
属性。例如:
import mlreportgen.dom.* p = Paragraph('Danger!'); p.Style = [p.Style {Color('red'),FontFamily('Arial'),FontSize('18pt')}];
这种做法可防止无意中删除您先前添加的格式对象或 DOM API 添加的用于将 Style
属性与格式属性。请参阅格式属性。
您可以将相同的格式对象数组分配给多个 DOM 文档对象。此技术允许您创建模板样式表的程序等效项。例如:
import mlreportgen.dom.* warning = {Color('red'),FontFamily('Arial'),FontSize('18pt')}; p = Paragraph('Danger!'); p.Style = [p.Style warning]; p = Paragraph('Caution!'); p.Style = warning;
DOM API 允许您将任何格式对象分配给任何文档对象,无论该格式是否适用。如果格式不适用,则会被忽略。
格式属性
大多数 DOM 对象都有一组属性,与该类对象最常用的格式选项相对应。例如,此代码使用 Paragraph
对象的 Color
、FontFamily
和 FontSize
格式属性设置段落中文本的字体和颜色。
import mlreportgen.dom.* p = Paragraph('Danger!'); p.Color = 'red'; p.FontFamilyName = 'Arial'; p.FontSize = '18pt';