模板中的样式表

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';