主要内容

记者模板

本参考资料描述了这些记者使用的模板:

使用此信息可创建自定义模板，用于这些报表之一或从这些报表派生的报表中使用。

部分模板

的支持的三种输出类型中的每一种，Section报表都使用六组模板金宝appMATLAB®报告生成器™: docx、pdf、html。每个集合对应于节层次结构的六个级别部分记者可以生成。第一个集合对应于顶级节，第二个集合对应于顶级节的二级子节，以此类推。

每个关卡集包含三个模板:

一个部分报表程序确定在报表程序将报表程序添加到报表对象时使用哪个集。例如，当您的报表程序添加部分的报告对象部分Reporter使用顶级模板集。一个部分当报表的add方法将二级模板集作为顶级节报表的内容的一部分添加到报表中时，报表使用二级模板集。一个部分当报表添加方法将第三级模板集作为二级报表内容的一部分添加到报表中时，报表使用第三级模板集。

Section1模板

的部分报告者的Word、PDF和HTML Section1模板分别指定由section 1报告者在Word、PDF和HTML报告中生成的顶级节的格式。的默认样式和孔的位置部分记者的标题而且内容属性。

此外，PDF和Word模板指定顶级部分的页面布局属性，包括顶级Word或PDF部分的页面方向、页边距、页眉和页脚。Word和PDF模板为节的第一页和后面的页指定不同的页眉。第一页的标题只包含一条规则。后续页的页眉，称为默认页眉，包含节标题。第一页页脚和后续页页脚是相同的。

顶级部分开始于具有顶级指定属性的新页面部分记者的模板。容纳顶级节内容所需的所有后续页面都具有相同的页面布局，除非内容本身指定了新的页面布局，在这种情况下，后续页面的页面布局将发生变化。默认的低级节模板不指定页面布局。因此，向节中添加子节并不会改变页面布局。子节的内容具有与顶级节相同的布局。

  • Section1模板

    的“快速部件”库中驻留了Word Section1模板部分记者的default.dotx模板文件。QuickParts库用作部分记者的Word模板库。要查看或编辑Section1模板，必须打开default.dotx文件中创建模板的实例default.dotx模板。Section1模板在Word中显示如下:

    请注意

    当您显示Word Section1模板的副本时，它将滚动到第二页的默认页眉，该页眉将显示一条错误消息。有关此错误消息的解释，请参阅下面的说明。要查看模板孔，请滚动到模板顶部。

    Section 1模板为Section的第一页指定了不同于后续页的页头。除第一页外的所有页眉都称为默认页眉。第一个页头包含一个规则，但其他部分为空。

    请注意

    该规则被实现为带有下边框的空段落。段落的字体大小被设置为一个非常低的值，以最小化段落的高度。

    第一页页脚包含一个Word页码字段。当在Word中打开此模板或由此生成的报表时，Word将该字段替换为页脚所在的页码。

    Section1的默认页头包含一个Word StyleRef字段，该字段引用了该节的标题样式(即SectionTitle)。当在Word中打开模板或从模板生成的报告时，Word将StyleRef字段替换为具有SectionTitle样式的节中第一段的内容。在报告中，该段落包含该节的标题。因此，节的标题出现在第一页后面的页头中。(这在文档设计中被称为运行头。)

    请注意

    Section1模板占用的页面小于1页。因此，当您将Section1模板从Section记者的QuickPart图库(即模板库)复制到default.dotx模板时，只显示节的第一页。但是，Word创建一个带有继承Section1模板的页头的新节(section 2)的页面。Word用错误消息替换这个新节标题中的StyleRef字段，因为新节中没有引用样式的段落。

    Section1模板指定了一个默认页脚，该页脚的内容和格式与第一个页脚相同。

    请注意

    要查看或编辑默认页脚，必须按如下方式在Section1模板中插入一个页面:

    1. 中复制模板部分报告模板的QuickParts库(即其模板库)转移到报告模板的主体。

    2. 在模板的Content洞后插入一段。

    3. 启用段落的换页前财产。

  • PDF Section1模板

    PDF Section1模板驻留在Section报告人的PDF模板文件(default.pdftx)．模板文件为zip文件。它将模板库存储在一个名为docpart_templates.html．查看或编辑Section1模板:

    1. 的副本解压缩default.pdftx文件使用报表APIunzipTemplate命令。

    2. 打开docpart_templates.html文件在MATLAB编辑器或任何其他文本编辑器。

    3. 当您完成Section1模板的编辑时，保存docpart_templates.html文件。

    4. Rezip的default.pdftx文件，使用报表APIzipTemplate命令。

    有关更多信息，请参见创建PDF文档部分模板库．

    类生成的顶级PDF节的页面布局，PDF Section1模板使用以下HTML标记来定义部分记者。类的内容所填充的孔的位置也由标记定义部分记者的标题而且内容属性。

    Section1布局中的pheader和pfooter元素指定了用于定义顶级节的页眉和页脚的内容和布局的模板。页眉模板和页脚模板位于同一个模板库文件(docpart_templates.html)作为Section1模板本身。的部分“报表”只使用第一页和默认页模板。

    第一个页眉和页脚模板是

    标题模板指定一个空段落后跟一个水平规则。空段落指定样式SectionTitleHead。它在模板的样式表中定义(见下文)。第一个页脚模板指定一个水平规则，后面跟着一个页码。

    默认的页头模板

    指定包含styleref和水平规则的段落。在生成报告期间，report API将styleref元素替换为顶级部分的标题段的内容，从而创建一个运行头。

    默认的页脚模板

    指定一个水平规则，后面跟着一个自动生成的页码。

    页眉和页脚模板的样式位于pdf格式/样式表/ root.css文件。

  • HTML Section1模板

    中的Section1文档部分模板default.htmt文件指定标题和内容孔。

Section2 - Section6模板

Section2-Section6模板指定子节的格式部分记者。每个模板都包含孔元素，这些孔元素指定要用Section报告器的内容填充的孔的位置标题而且内容属性,分别。每个模板中的Title孔指定了特定于模板定义的子级别的默认标题样式。

  • 单词Section2 - Section6模板

    作为一个例子，这个图像显示了Section2模板。

  • PDF和HTML Section2 - Section6模板

    作为一个例子，这个图像显示了Section2模板。

模板孔

所有Section模板(Section1 - Section6)都有该表中描述的孔。

持身份证 孔类型 描述

标题

块

的部分报告程序根据其Title属性的内容类型填充此洞，如下所示。

  • 如果标题属性内容是内联对象，例如字符串或mlreportgen.domText对象时，Section报告程序使用SectionTitle报告器来格式化和生成作为标题的内联内容。然后它将生成的内容添加到Title洞。的SectionTitle报表使用模板格式化内联内容。

  • 如果它的标题属性内容是段落或其他块级对象部分记者把这段话加到标题洞里。

  • 如果它的标题属性内容是另一个报告器部分报告者将报告者生成的内容添加到标题洞。

内容

块

本节内容

模板样式

Section模板使用样式来格式化一些内容。的样式表中定义它们在样式表中使用的样式default.dotx模板文件。控件中的样式定义为PDF和HTML模板样式表/ root.css在default.pdftx而且default.htmt文件,分别。下表描述了Section模板使用的样式。

风格的名称 风格类型 描述

SectionContent

字符

 Section1-Section6模板中的Content洞将此样式指定为填充洞的内容的默认文本样式。内容可以指定覆盖默认样式的样式或格式。

SectionTitle1 - SectionTitle6

字符

相应的节模板中的Title孔指定相应的样式名作为节标题的默认样式。例如，Section1模板中的Title洞将SectionTitle1指定为顶级节标题的默认样式的名称。添加到标题洞的内容可以指定覆盖默认样式的格式或样式。

SectionTitleHeader

字符

Section1页标题使用这种样式将标题内容居中。

SectionTitleFooter

字符

Section1页脚对页脚内容使用这种样式。

章节标题模板

如果内容的部分记者的标题属性是一个字符串，文本或其他内联对象，它使用SectionTitle报告程序生成用于填充其节级模板中的标题洞的内容。的SectionTitleReporter反过来使用模板将内联内容格式化为标题。的SectionTitleReporter为每种输出类型使用两组模板，一组用于创建按层次结构编号的标题(1.1、1.2、1.2.1等等)，另一组用于创建无编号的标题。每个集合包含6个模板，对应于的6个级别的节部分记者可以生成。这些模板位于Section记者的Word、PDF和HTML模板文件的模板库中，default.dotx，default.pdftx,default.htmt,分别。

编号的章节标题模板

如果报告或部分报表程序指定其标题编号为SectionTitle的内联内容格式化部分记者的标题财产。标题被命名为SectionNumberedTitleN,在那里N模板应用到的节级别。例如，顶级节标题的模板名称是SectionNumberedTitle1。每个模板都包含一个段落元素，该元素指定的样式与对应的节级模板中的标题孔所指定的样式相同，例如，顶级节标题的SectionTitle1。看到模板样式．

标题段包含以下漏洞。

  • 要用内容填充的NumberPrefix洞SectionTitle记者的NumberPrefix属性(默认为空)

  • 自动编号标记，在报告生成过程中由层次编号替换。每个级别模板的自动编号标记都不同，以便生成适合于该级别的层次编号。

  • 类的内容填充NumberSuffix洞SectionTitle记者的NumberSuffix属性(默认为空)。

  • 内容孔要用内容填满SectionTitle记者的内容财产。

下面的图像分别显示了Word、PDF和HTML SectionNumberedTitle1模板。较低级别的模板也类似。

  • Word SectionNumberedTitle1模板

  • SectionNumberedTitle1模板

  • HTML sectionnumbered标题1模板

在生成报表期间，部分报告人设置内容的属性SectionTitle报告器的内联内容部分记者的标题财产。它不设置NumberPrefix而且NumberSuffix属性。这样，标题就生成了SectionTitle报告器默认由一个层次数字后面跟着标题文本组成。

的SectionTitle报告器提供了NumberPrefix和NumberSuffix孔，以方便派生报告器对标题进行标记。例如，章报告器，其派生自部分，则设置NumberPrefix属性到章节在英语地区。在一些东亚地区，章报告人设置NumberSuffix到指定章节的字符。

请注意

如果自定义有编号的节模板，请勿删除或替换Word模板中的SEQ字段或PDF或HTML模板中的自动编号标记。要生成未编号的节，请使用未编号的节标题模板．

SectionNumberedTitle模板孔

所有SectionNumberedTitle模板(Section1 - Section6)都有该表中描述的孔。

洞ID 孔类型 描述

NumberPrefix

内联

在节号之前显示的前缀。

NumberSuffix

内联

在节号之后显示的后缀。

内容

内联

标题内容

未编号的节标题模板

如果报告指定当前部分使用未编号的标题，则SectionTitle报告器使用无编号模板生成节标题。没有编号的模板被命名为SectionTitleN在哪里N要生成其标题的节的级别。例如，顶级部分的模板名为SectionTitle1。每个模板都包含一个段落元素，该元素指定的样式与对应节级模板中的标题孔所指定的样式相同，例如，顶级节标题的SectionTitle1。看到模板样式．标题段有一个缺口，需要由SectionReporter的内容来填补内容属性设置部分报告生成时的报告程序)。

下面的图片显示了SectionTitle1模板的Word、PDF和HTML版本。较低级别的模板也类似。

  • Word SectionTitle模板

    所有级别的Word SectionTitle模板都有相同的内容孔。

  • PDF和HTML SectionTitle1模板

  • PDF和HTML SectionTitle2 - SectionTitle6模板

    这些节标题模板包括一个Content孔，如SectionTitle1模板中所示。每个部分都指定了它的标题样式。

SectionTitle模板孔

所有SectionTitle模板(Section1 - Section6)都包含该表中描述的孔。

洞ID 孔类型 描述

内容

内联

标题内容

章模板

的章类的子类部分，使用部分报表程序的顶级模板集，以生成其内容。这是因为chapter生成的节与section生成的节几乎相同。然而，这两种类型的章节在两个方面有所不同:

  • 章节节的标题在英语地区包含单词chapter，在Report API支持的其他地区包含相同的单词chapter。金宝app的章属性在标题中包含章节一词NumberPrefix或NumberSuffix的属性SectionTitle用于生成章节标题的报表。

  • 所有section生成的顶级节都从第1页开始。相比之下，只有第一章由a生成章记者从第一页开始。随后的章节继续上一章的页码。的章报告器以编程方式实现此行为，从而避免了使用Section顶级模板的修改版本的需要。

看到Section1模板，编号的章节标题模板,未编号的节标题模板