Main Content

mlreportgen.report.TitlePage class

Package:mlreportgen.report
Superclasses:mlreportgen.report.Reporter

Title page reporter

expand all in page

Description

Use an object of themlreportgen.report.TitlePageclass to add a title page to a report.

Themlreportgen.report.TitlePageclass is ahandleclass.

Class Attributes

HandleCompatible
true

Creation

Description

example

tp = mlreportgen.report.TitlePage()creates a title page reporter that uses the default title page template.

tp= mlreportgen.report.TitlePage(Name,Value)sets properties using name-value pairs. You can specify multiple name-value pair arguments in any order. Enclose each property name in single or double quotes.

Properties

expand all

Title page title, specified as one of these values:

  • String scalar or character vector

  • DOM object

  • 1-by-NorN-by-1 array of strings or DOM objects

  • 1-by-NorN-by-1 cell array of strings, character vectors, or DOM objects

  • A Reporter created by thegetTitleReportermethod of this title page

Example:tp.Title = "My Report";

Attributes:

GetAccess
public
SetAccess
public

Report subtitle, specified as one of these values:

  • String scalar or character vector

  • DOM object

  • 1-by-NorN-by-1 array of strings or DOM objects

  • 1-by-NorN-by-1 cell array of strings, character vectors, or DOM objects

  • Reporter created by thegetSubtitleReportermethod of this title page

Example:tp.Subtitle = "Part I";

Attributes:

GetAccess
public
SetAccess
public

Image to insert in title page, specified as one of these values:

  • String scalar or character vector that specifies the file system path of the image

  • mlreportgen.report.Figurereporter

  • DOM object

  • 1-by-NorN-by-1 cell array of image paths, snapshot makers, or DOM objects

  • Reporter created by thegetImageReportermethod of this title page

Images formats with these file extensions are supported:

  • .bmp– Bitmap

  • .gif– Graphics Interchange Format

  • .jpg– JPEG

  • .png– Portable Network Graphics

  • .emf– Enhanced metafile (supported only in.docxoutput on Windows)

  • .svg– Scalable Vector Graphic

  • .tif– Tag Image File

Example:tp.Image = "reports/imagedir/titleimage.jpg";

Attributes:

GetAccess
public
SetAccess
public

Report author, specified as one of these values:

  • String scalar or character vector

  • DOM object

  • 1-by-NorN-by-1 array of strings or DOM objects

  • 1-by-NorN-by-1 cell array of strings, character vectors, or DOM objects

  • Reporter created by thegetAuthorReportermethod of this title page

If the environment variable user name is not found, the default value is empty.

Example:TitlePage("Author","John Smith")

Attributes:

GetAccess
public
SetAccess
public

Report publisher, specified as one of these values:

  • String scalar or character vector

  • DOM object

  • 1-by-NorN-by-1 array of strings or DOM objects

  • 1-by-NorN-by-1 cell array of strings, character vectors, or DOM objects

  • Reporter created by thegetPublisherReportermethod of this title page

Example:tp.Publisher = "Smith Company";

Attributes:

GetAccess
public
SetAccess
public

Report publication date, specified as one of these values:

  • String scalar or character vector

  • DOM object

  • 1-by-NorN-by-1 array of strings or DOM objects

  • 1-by-NorN-by-1 cell array of strings, character vectors, DOM objects

  • Reporter created by thegetPubDateReportermethod of this title page

Example:tp.PubDate = "April 23, 2017";

Attributes:

GetAccess
public
SetAccess
public

Page layout for the title page, specified as anmlreportgen.report.ReporterLayoutobject. Use the properties of theReporterLayoutobject to override the default page layout properties, such as page orientation.

Attributes:

GetAccess
public
SetAccess
Restricts access

Source of the template for this reporter, specified in one of these ways:

  • Character vector or string scalar that specifies the path of the file that contains the template for this reporter

  • Reporter or report whose template is used for this reporter or whose template library contains the template for this reporter

  • DOM document or document part whose template is used for this reporter or whose template library contains the template for this reporter

指定的模板必须相同类型作为the report to which this reporter is appended. For example, for aMicrosoft®Wordreport,TemplateSrcmust be a Word reporter template. If theTemplateSrcproperty is empty, this reporter uses the default reporter template for the output type of the report.

Attributes:

GetAccess
public
SetAccess
public

Name of the template for this reporter, specified as a character vector or string scalar. The template for this reporter must be in the template library of the template specified by theTemplateSrcproperty of this reporter.

Attributes:

GetAccess
public
SetAccess
public

Hyperlink target for this reporter, specified as a character vector or string scalar that specifies the link target ID, or anmlreportgen.dom.LinkTargetobject. A character vector or string scalar value is converted to aLinkTargetobject. The link target immediately precedes the content of this reporter in the output report.

Attributes:

GetAccess
public
SetAccess
public

Methods

expand all

Examples

collapse all

Create a title page that uses the default formatting. Add the title page to the report and view the report.

importmlreportgen.report.*rpt = Report("output","pdf"); tp = TitlePage(); tp.Title ="Aircraft Tests"; tp.Subtitle ="Monthly Data"; tp.Image = which("b747.jpg"); tp.Author ="John Smith"; tp.Publisher ="MathWorks"; tp.PubDate = date(); add(rpt,tp); close(rpt); rptview(rpt);

Create a title page that uses the default title format, but changes the title color to red. Specify theTitleproperty as a DOMTextobject and set its color to red.

importmlreportgen.report.*importmlreportgen.dom.*rpt = Report("output","pdf"); tp = TitlePage; tp.Title = Text("Aircraft Tests"); tp.Title.Color ="red"; add(rpt,tp); close(rpt); rptview(rpt);

Create a title page that overrides the title property formatting. Change the title font to 24-point Arial, the title text color to white, and use a blue background. Any styles you do not specify use themlreportgen.dom.Paragraphclass defaults.

importmlreportgen.report.*importmlreportgen.dom.*rpt = Report("output","pdf"); tp = TitlePage(); title = Paragraph("Aircraft Tests"); title.Style = {HAlign("left"),FontFamily("Arial"),...FontSize("24pt"),Color("white"),...BackgroundColor("blue"),...OuterMargin("0in","0in",".5in","1in"),...HAlign("center")}; tp.Title = title; tp.Subtitle ="Monthly Data"; tp.Image = which("b747.jpg"); tp.Author ="John Smith"; tp.Publisher ="MathWorks"; tp.PubDate = date(); add(rpt, tp); close(rpt); rptview(rpt);

The template for aTitlePageobject determines the page orientation, page margins, page size, and other page layout properties. You can customize and override the title page layout by using a customized version of the default template. You can also customize individual title page elements by customizing those element templates. TheTitlePagereporter supports two approaches to overriding title page element templates.

To use a customTitlePagetemplate:

Create a copy of the default title page template.

Edit the title page element templates as desired in the copy of the template. The names of the templates have the formTitlePageNAMEwhereNAMEtemplat的名称吗e in the template library. For example, the name of the title template isTitlePageTitle.

Set theTitlePageTemplateSrcproperty of the object to the path of the custom template.

This approach takes advantage of the fact that theTitlePageobject uses specialized reporters, called hole reporters, to apply element templates to the elements. Consequently, you can use theTitlePage方法来获取g the reporter to apply a template to a particular element. For example, thegetTitleReportermethod returns the reporter used for applying theTitlePageTitletemplate to the content of the report title.

Copy the title page element templates that you want to customize into a different template library. For example, you can copy the template library of the report or the template library of a DOM document part object. These template libraries are often libraries that you created to store customized versions of templates.

For each title page element to be customized, get its element reporter. For example, for the title, use thegetTitleReportermethod.

Set theTemplateSrcproperty of the element reporter to the source of the template library containing the customized version of the element template.

SetContentproperty of the element reporter to the element content.

Set the title page object element property to the element reporter object.

importmlreportgen.report.*importmlreportgen.dom.*rpt = Report("MyReport","pdf","MyCustomPDFTemplate"); tp = TitlePage; titleReporter = getTitleReporter(tp); titleReporter.TemplateSrc = rpt; titleReporter.Content ="My Report"; tp.Title = titleReporter;

See Also

Topics

Introduced in R2017b

MATLAB Report Generator Documentation

金宝app

Try MATLAB, Simulink, and Other Products

Get trial now