mlreportgen.report.section类

包:mlreportgen.report
超类:

部分记者

全部展开页面

描述

创建将节添加到报表的节报告器。此类继承自mlreportgen.report.reporter.reporter.。

建设

部分=部分（）创建生成报表部分的报告程序。您可以将节报表添加到报表、章节或其他节中。如果在报表中添加一个节，则该节从一个新的纵向页开始，页脚中有默认的页边距和页码。页码等于前一页的页码加一。如果您将该节添加到章节或其他节中，报告者将创建继续在当前页面上的子节。默认情况下，标题的大小会随着报表层次结构中部分深度的减小而减小，深度最高可达5层。低于5级的标题没有编号，字体大小与第5级相同。

部分=部分（标题）创建一个报告部分，其中包含指定标题文本的部分标题。分层部分编号默认为标题文本前缀。例如，第二章中的第一个子部分的默认编号为2.1。标题的字体大小默认情况下，报表层次结构中的部分深度为深度为5级。

部分=部分（名称，价值）使用名称-值对设置属性。可以以任意顺序指定多个名称-值对参数。将每个属性名用单引号括起来。

输入参数

展开全部

`标题`- - - - - -部分标题
字符串|字符数组

看到标题财产。

属性

展开全部

`标题`- - - - - -部分标题
字符串|字符数组|……

章节标题，指定为以下值之一:

字符串或字符数组
DOM对象
一乘-N或N-by-1字符串或DOM对象数组
一乘-N或N-1字符串，字符阵列和/或DOM对象的1个单元格阵列
第一个记者

内联对象是段落可以包含的对象。如果标题值是内联对象，则部分对象使用一组模板中的一个模板。模板存储在该部分的模板库中。用于创建标题的模板取决于标题是编号的，部分层次结构中的部分级别。使用编号属性指定是否标题是否编号。

如果标题值是一个DOM段落或其他DOM块对象，则该节将在该节的开头插入该对象。如果使用DOM块对象，可以使用块元素定制节标题的间距、对齐和其他属性。在这种情况下，您必须完全指定标题格式并自行提供标题编号。

`编号`- - - - - -选择为这个部分编号
真的(默认)|错误的

选择为此部分编号，指定为逻辑。如果该属性的值为[]或真的，该部分相对于报告中的其他部分编号。部分编号出现在“标题”部分中。如果值是错误的，本节未编号。这个价值编号属性覆盖所有报告部分指定的编号mlreportgen.report.Section.number方法。

`内容`- - - - - -本节内容
字符串|字符数组|内联对象|……

该部分的内容，指定为其中一个值：

字符串或字符数组
可以添加到DOM文档部件的DOM对象
记者，包括部分记者
1 xN或Nx1字符串数组或字符阵列
1 xN或Nx1单元格数组的字符串，字符数组，和/或DOM对象

使用部分构造函数或添加设置此属性的方法。您无法直接设置。

`TemplateSrc`- - - - - -本报记者的模板来源
`[]`(默认)|字符向量|字符串标量|记者或报告|DOM文档或文档部分

本报记者的模板来源，以其中一种方式指定：

指定包含此报告器模板的文件路径的字符向量或字符串标量
该报表使用模板或模板库中包含该报表模板的报表或报表
DOM文档或文档部分，其模板用于此报表，或其模板库包含此报表的模板

指定的模板必须与附加记者附加的报告相同。例如，对于一个微软^®单词报告,TemplateSrc必须是一个单词报道模板。如果是TemplateSrc属性为空，此报告管理器使用报告的输出类型的默认报告器模板。

`模板名`- - - - - -记者的模板名称
字符向量|字符串标量

此报告器的模板名称，指定为字符向量或字符串标量。该报告程序的模板必须位于模板源的模板库中(TemplateSrc）对于本记者。

`链接目标`- - - - - -这个记者的超链接目标
`[]`(默认)|字符向量|字符串标量|`mlreportgen.dom.LinkTarget`对象

此报告器的超链接目标，指定为指定链接目标ID的字符向量或字符串标量，或mlreportgen.dom.LinkTarget对象。字符向量或字符串标量值转换为a链接目标对象。在输出报告中，链接目标紧跟在该报告的内容前面。

方法

添加	（不推荐）将内容添加到部分
附加	向section添加内容
createTemplate.	创建部分模板
定制竞争者	创建自定义部分报告课
getClassFolder	节类定义文件位置
gettitlereporter.	创建一个章节标题报告器
数字	设置部分编号

继承的方法

复制	创建报告对象的副本，并创建某些属性值的深度副本
GetImpl.	得到执行的记者

例子

向报告部分添加内容

这个例子将标题和图像添加到两个部分，并将部分添加到一个章节。

进口mlreportgen.report。*进口mlreportgen.dom。*RPT =报告（'我的报告'，“pdf”）;附加（RPT，TitlePage（'标题'，'我的报告'））;追加(rpt TableOfContents);ch =章('图片'）;附录（CH，部分（'标题'，'波音747'，．..“内容”、图像(('b747.jpg')))); 附加（第章，第节）('标题'，“辣椒”，．..“内容”，图像（哪个('peppers.png'))));追加(rpt, ch);关闭(rpt);rptview (rpt);

使用DOM Text对象作为部分标题

此示例使用DOM文本对象定义标题。通过使用DOM对象，您可以设置其属性并覆盖部分标题的默认黑色。

进口mlreportgen.report。*进口mlreportgen.dom。*RPT =报告（'新报告'，“pdf”）;打开（RPT）Sect =部分;sect.title = text（“一节”）;sect.Title.Color ='蓝色'；追加(rpt,教派);关上(rpt) rptview (rpt)

更改截面的对齐方式

此示例生成一个报告，该报告将子部分标题设置为中心对齐。

进口mlreportgen.report。*进口mlreportgen.dom。*RPT =报告（'我的报告'，“html”）;附加（RPT，TitlePage（'标题'，'我的报告'））;追加(rpt TableOfContents);chTitle = Heading1 ('章节 '）;chTitle。风格= {CounterInc ('sect1'），．..空格（'保存'）．..颜色(“黑”），．..粗体，fontsize（“24 pt”）};附录（脊髓灰岩，自动数（'sect1')); 附加（标题，'。'）;secttitle = heading2（）;secttitle.style = {utforc（'sect2'），．..空格（'保存'）．..哈利恩(“中心”），pagebreakbefore};追加(sectTitle AutoNumber ('sect1'））;附录（secttitle，“。”）;追加(sectTitle AutoNumber ('sect2'））;附录（secttitle，'。'）;title =克隆(chTitle);追加(标题、'图片'）;ch =章('标题'，title）；title=clone（sectTitle（））；append（title，'波音747'）;附录（CH，部分（'标题'，标题，“内容”，．..图像（哪个（'b747.jpg'))));title =克隆(sectTitle ());追加(标题、“辣椒”）;附录（CH，部分（'标题'，标题，“内容”，．..图像（哪个（'peppers.png'))));追加(rpt, ch);关闭(rpt);rptview (rpt);

兼容性考虑因素

展开全部

`添加`不建议使用方法

在R2020B中不推荐

从R2020B开始，使用附加方法而不是添加方法将内容添加到这些报告API类的对象中:

mlreportgen.report.report
mlreportgen.report.Chapter
mlreportgen.report.section.

要向DOM API对象添加内容，例如mlreportgen.dom.Paragraph对象，继续使用附加DOM对象的方法。使用的优点附加要添加以报告API对象的内容是您使用与要将内容添加到DOM API对象的相同方法名称。

目前还没有拆除的计划添加调查方法报告，章节,或部分类。报告使用添加方法将继续运行。

要更新现有代码，请替换方法名添加和附加如表中的例子所示。

不建议	受到推崇的
进口mlreportgen.report。进口mlreportgen.dom。RPT =报告（“我的报告”，“pdf”）;ch =章(“我的章节”）;sect =部分（“我的部分”）;帕拉=段(“我的内容”）;附录（Para，“更多内容”）;添加(教派,para);添加(ch,教派);add (rpt, ch);关闭(rpt);rptview (rpt);	进口mlreportgen.report。进口mlreportgen.dom。RPT =报告（“我的报告”，“pdf”）;ch =章(“我的章节”）;sect =部分（“我的部分”）;帕拉=段(“我的内容”）;附录（Para，“更多内容”）;追加(教派,para);追加(ch,教派);追加(rpt, ch);关闭(rpt);rptview (rpt);

不建议

受到推崇的

进口mlreportgen.report。*进口mlreportgen.dom。*RPT =报告（“我的报告”，“pdf”）;ch =章(“我的章节”）;sect =部分（“我的部分”）;帕拉=段(“我的内容”）;附录（Para，“更多内容”）;添加(教派,para);添加(ch,教派);add (rpt, ch);关闭(rpt);rptview (rpt);

进口mlreportgen.report。*进口mlreportgen.dom。*RPT =报告（“我的报告”，“pdf”）;ch =章(“我的章节”）;sect =部分（“我的部分”）;帕拉=段(“我的内容”）;附录（Para，“更多内容”）;追加(教派,para);追加(ch,教派);追加(rpt, ch);关闭(rpt);rptview (rpt);