Main Content

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

报告格式化方法

您可以使用样式表、格式对象、格式属性或这些方法的组合来格式化报告。

模板中的样式表

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 对象的 ColorFontFamilyFontSize 格式属性设置段落中文本的字体和颜色。

import mlreportgen.dom.*

p = Paragraph('Danger!');
p.Color = 'red';
p.FontFamilyName = 'Arial';
p.FontSize = '18pt';

相关主题