主要内容

mlreportgen.report.TitlePage类

包:mlreportgen.report
超类:mlreportgen.report.Reporter

扉页记者

描述

对象的对象mlreportgen.report.TitlePage类向报表添加标题页。

mlreportgen.report.TitlePage类是一个处理类。

类属性

HandleCompatible
真正的

创建

描述

例子

tp = mlreportgen.report.TitlePage()创建使用默认标题页模板的标题页报告程序。

tp= mlreportgen.report.TitlePage (名称=值使用名称-值对设置属性。您可以以任意顺序指定多个名称-值对参数。

属性

全部展开

Title页标题,指定为以下值之一:

  • 字符串标量或字符向量

  • DOM对象

  • 1 -NN字符串或DOM对象的-by-1数组

  • 1 -NN字符串、字符向量或DOM对象的-by-1单元格数组

  • 创建的报告getTitleReporter此标题页的方法

例子:tp。标题=“我的报告”;

属性:

GetAccess
公共
SetAccess
公共

报告子标题,指定为以下值之一:

  • 字符串标量或字符向量

  • DOM对象

  • 1 -NN字符串或DOM对象的-by-1数组

  • 1 -NN字符串、字符向量或DOM对象的-by-1单元格数组

  • getSubtitleReporter此标题页的方法

例子:tp。字幕=“第一部分”;

属性:

GetAccess
公共
SetAccess
公共

要插入标题页的图像,指定为以下值之一:

  • 指定映像的文件系统路径的字符串标量或字符向量

  • mlreportgen.report.Figure记者

  • DOM对象

  • 1 -NN图像路径、快照生成器或DOM对象的-by-1单元格数组

  • getImageReporter此标题页的方法

支持以下文件扩展名的图像格式:金宝app

  • bmp格式——位图

  • gif-图形交换格式

  • jpg——JPEG

  • . png-便携式网络图形

  • .emf—增强的元文件(仅支持金宝app。docx在Windows上输出)

  • .-可缩放矢量图形

  • .tif-标签图像文件

例子:tp。图片= "reports/imagedir/titleimage.jpg";

属性:

GetAccess
公共
SetAccess
公共

报告作者,指定为以下值之一:

  • 字符串标量或字符向量

  • DOM对象

  • 1 -NN字符串或DOM对象的-by-1数组

  • 1 -NN字符串、字符向量或DOM对象的-by-1单元格数组

  • getAuthorReporter此标题页的方法

如果没有找到环境变量user name,则默认值为空。

例子:TitlePage(“作者”,“约翰·史密斯”)

属性:

GetAccess
公共
SetAccess
公共

报表发布者,指定为以下值之一:

  • 字符串标量或字符向量

  • DOM对象

  • 1 -NN字符串或DOM对象的-by-1数组

  • 1 -NN字符串、字符向量或DOM对象的-by-1单元格数组

  • getPublisherReporter此标题页的方法

例子:tp。出版商=“史密斯公司”;

属性:

GetAccess
公共
SetAccess
公共

报告发布日期,指定为以下值之一:

  • 字符串标量或字符向量

  • DOM对象

  • 1 -NN字符串或DOM对象的-by-1数组

  • 1 -NN-by-1单元格数组的字符串,字符向量,DOM对象

  • getPubDateReporter此标题页的方法

例子:tp。PubDate = " 2017年4月23日";

属性:

GetAccess
公共
SetAccess
公共

标题页的页面布局,指定为mlreportgen.report.ReporterLayout对象。属性的属性ReporterLayout对象重写默认页面布局属性,例如页面方向。

属性:

GetAccess
公共
SetAccess
限制访问

此报告的模板源,通过以下方式之一指定:

  • 字符向量或字符串标量,指定包含此报表模板的文件的路径

  • 报表或报表,其模板用于此报表,或其模板库包含此报表的模板

  • DOM文档或文档部分,其模板用于此报表,或其模板库包含此报表的模板

指定的模板必须与该报表附加到的报表类型相同。例如,对于a微软®报告,TemplateSrc必须是Word报表模板。如果TemplateSrc属性为空时,此报表将为报表的输出类型使用默认报表模板。

属性:

GetAccess
公共
SetAccess
公共

此报表的模板名称,指定为字符向量或字符串标量。属性指定的模板的模板库中必须包含此报表的模板TemplateSrc记者的财产。

属性:

GetAccess
公共
SetAccess
公共

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

属性:

GetAccess
公共
SetAccess
公共

方法

全部展开

例子

全部折叠

创建一个使用默认格式的标题页。将标题页添加到报表并查看报表。

进口mlreportgen.report。*rpt =报告(“输出”“pdf”);tp = TitlePage();tp。Title =“飞机测试”;tp。字幕=“月度数据”;tp。Image = which(“b747.jpg”);tp。作者=“约翰·史密斯”;tp。出版商=“MathWorks”;tp。PubDate = date();add (rpt, tp);关闭(rpt);rptview (rpt);

创建一个使用默认标题格式的标题页,但将标题颜色更改为红色。指定标题属性作为DOM文本对象,并将其颜色设置为红色。

进口mlreportgen.report。*进口mlreportgen.dom。*rpt =报告(“输出”“pdf”);tp = TitlePage;tp。标题=文本(“飞机测试”);tp.Title.Color =“红色”;add (rpt, tp);关闭(rpt);rptview (rpt);

创建一个覆盖title属性格式的标题页。将标题字体更改为24-point Arial,标题文本颜色更改为白色,并使用蓝色背景。未指定的任何样式使用mlreportgen.dom.Paragraph类违约。

进口mlreportgen.report。*进口mlreportgen.dom。*rpt =报告(“输出”“pdf”);tp = TitlePage();标题=段落(“飞机测试”);标题。样式= {HAlign(“左”), FontFamily (“天线”),...字形大小(“24 pt”),颜色(“白色”),...写成BackgroundColor (“蓝色”),...OuterMargin (“0”“0”“.5in”“1”),...HAlign (“中心”)};tp。标题=标题;tp。字幕=“月度数据”;tp。Image = which(“b747.jpg”);tp。作者=“约翰·史密斯”;tp。出版商=“MathWorks”;tp。PubDate = date();add (rpt, tp);关闭(rpt);rptview (rpt);

的模板。TitlePage对象确定页面方向、页面边距、页面大小和其他页面布局属性。通过使用默认模板的自定义版本,可以自定义和覆盖标题页布局。您还可以通过自定义那些元素模板来自定义各个标题页元素。的TitlePageReporter支金宝app持两种重写标题页元素模板的方法。

要使用自定义TitlePage模板:

创建默认标题页模板的副本。

在模板副本中按需要编辑标题页元素模板。模板的名称具有表单TitlePageNAME在哪里的名字模板库中模板的名称。例如,标题模板的名称为TitlePageTitle

设置TitlePageTemplateSrc属性设置为自定义模板的路径。

这种方法利用了TitlePage对象使用专门的报告程序(称为孔报告程序)将元素模板应用于元素。因此,您可以使用TitlePage方法,用于使报表程序将模板应用于特定元素。例如,getTitleReporter方法返回用于应用TitlePageTitle模板添加到报表标题的内容中。

将要自定义的标题页元素模板复制到不同的模板库中。例如,您可以复制报表的模板库或DOM文档部件对象的模板库。这些模板库通常是创建来存储定制版本的模板的库。

对于要自定义的每个标题页元素,获取其元素报告器。例如,对于标题,使用getTitleReporter方法。

设置TemplateSrc属性设置为包含元素模板的自定义版本的模板库的源。

内容元素报告程序的元素内容。

将标题页对象元素属性设置为元素报告器对象。

进口mlreportgen.report。*进口mlreportgen.dom。*rpt =报告(“MyReport”“pdf”“MyCustomPDFTemplate”);tp = TitlePage;titleReporter = getTitleReporter(tp);titleReporter。TemplateSrc= rpt; titleReporter.Content =“我的报告”;tp。Title = titleReporter;

版本历史

在R2017b中引入