mlreportgen.report.ListOfCaptions Class

Namespace: mlreportgen.report
Superclasses: mlreportgen.report.Reporter

List of captions reporter

Description

Use an object of the mlreportgen.report.ListOfCaptions class to create a reporter that adds a section for a list of captioned report elements to a report. To create a reporter for a list of figures with captions or tables with titles, use objects of the mlreportgen.report.ListOfFigure and mlreportgen.report.ListOfTables classes, respectively. To create a reporter for a list for other types of report elements, such as equations, use a ListOfCaptions object.

To identify the report elements to include in the list of captions:

1. Choose a numbering stream name, for example, equation. Set the AutoNumberStreamName property of the ListOfCaptions object to the numbering stream name.

2. Create captions for the report objects as mlreportgen.dom.Paragraph objects.

3. Associate the Paragraph objects with the numbering stream name by using an mlreportgen.dom.AutoNumber object.

The generated list of captions contains the captions associated with the specified numbering stream name. The list entries link to the captions in the report. In PDF and Word reports, the list also includes the page numbers of the captions in the report. A leader fills the space between a caption and its page number.

The way the list of captions is generated depends on the report type:

• PDF — The Report API generates the list during report generation.

• Word — The Report API generates a placeholder for the list. To generate the list items, you must update the Word document in your report generation program or in Word. See Update Tables of Contents and Generated Lists in Word Documents.

• HTML — The Report API generates a placeholder for the list. When the report opens in an HTML browser, the browser generates the list in a sidebar.

Note

You can use a ListOfCaptions reporter for captions that follow a report element or titles that precede a report element.

The mlreportgen.report.ListOfCaptions class is a handle class.

Class Attributes

HandleCompatible

true

For information on class attributes, see Class Attributes.

Creation

Description

loc = mlreportgen.report.ListOfCaptions creates a ListOfCaptions reporter with default property values. Specify the list of captions section title by setting the Title property.

lof = mlreportgen.report.ListOfCaptions(title) creates a ListOfCaptions reporter with the Title property set to the specified title.

lof = mlreportgen.report.ListOfCaptions(Name=Value) sets properties using name-value arguments. You can specify multiple name-value arguments in any order.

Properties

Title — List of captions section title

[] (default) | character vector | string scalar | inline DOM object | mlreportgen.report.Title object | ...

List of captions section title, specified as one of these values:

• character vector or string scalar

• Inline DOM object, such as an mlreportgen.dom.Text object

• 1-by-N or N-by-1 array of string scalars or inline DOM objects

• 1-by-N or N-by-1 cell array that contains any combination of strings, character vectors, or inline DOM objects

• mlreportgen.report.Title object returned by the getTitleReporter method

Attributes:

GetAccess	public
SetAccess	public

AutoNumberStreamName — Name of numbering stream

" " (default) | character vector | string scalar

Name of numbering stream, specified as a character vector or string scalar.

Attributes:

GetAccess	public
SetAccess	public

Data Types: char | string

LeaderPattern — Type of leader

"." (default) | "dots" | " " | "space"

Type of leader to use between the title and the page number, specified as one of these character vectors or string scalars:

• "." or "dots"

• " " or "space"

Note

This property applies only to PDF reports. Word reports always have a dots leader. HTML reports do not have a leader.

Attributes:

GetAccess	public
SetAccess	public
NonCopyable	true

Data Types: char | string

Layout — Page layout

mlreportgen.report.ReporterLayout object (default)

Page layout for the list of captions section, specified as an mlreportgen.report.ReporterLayout object. Use the properties of the ReporterLayout object to override some of the default page layout properties, such as page orientation.

Attributes:

GetAccess	public
SetAccess	public

TemplateSrc — Source of template for this reporter

character vector | string scalar | reporter or report | DOM document or document part

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 this reporter uses or whose template library contains the template for this reporter

• Document Object Model (DOM) document or document part whose template this reporter uses or whose template library contains the template for this reporter

The specified template must be the same type as the report to which you append this reporter. For example, for a Microsoft^® Word report, TemplateSrc must be a Word reporter template. If the TemplateSrc property is empty, this reporter uses the default reporter template for the output type of the report.

Attributes:

GetAccess	public
SetAccess	public
NonCopyable	true

TemplateName — Name of template for this reporter

character vector | string scalar

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 the TemplateSrc property of this reporter.

Attributes:

GetAccess	public
SetAccess	public

Data Types: char | string

LinkTarget — Hyperlink target for this reporter

[] (default) | character vector | string scalar | mlreportgen.dom.LinkTarget object

Hyperlink target for this reporter, specified as a character vector or string scalar that specifies the link target ID, or an mlreportgen.dom.LinkTarget object. A character vector or string scalar value converts to a LinkTarget object. The link target immediately precedes the content of this reporter in the output report.

Attributes:

GetAccess	public
SetAccess	public

Methods

Public Methods

Method	Purpose
getTitleReporter	Get list of captions title reporter
mlreportgen.report.ListOfCaptions.createTemplate	template = mlreportgen.report.ListOfCaptions.createTemplate(path,type) Create reporter template Input Arguments path, Target path and file name for template file type, Template type, specified as "html", "docx", or "pdf" Return Values template — Path and file name of the template copy, returned as a string scalar. For more information, see the equivalent method for the Reporter class, mlreportgen.report.Reporter.createTemplate.
mlreportgen.report.ListOfCaptions.customizeReporter	reporter = mlreportgen.report.ListOfCaptions.customizeReporter(classpath) Create reporter derived from mlreportgen.report.ListOfCaptions class Return Values reporter — Path and file name of the new reporter class, returned as a string scalar. For more information, see the equivalent method for the Reporter class, mlreportgen.report.Reporter.customizeReporter.
mlreportgen.report.ListOfCaptions.getClassFolder	path = mlreportgen.report.ListOfCaptions.getClassFolder Get location of folder that contains mlreportgen.report.ListOfCaptions class definition file Return Values path — Class definition file location, returned as a character vector. For more information, see the equivalent method for the Reporter class, mlreportgen.report.Reporter.getClassFolder.
copy	Create copy of reporter object and make deep copies of certain property values
getImpl	Get implementation of reporter

Examples

Generate a List of Equations Section in a Report

This example generates a section for a list of the captions of the equations in a report. You can use the same procedure to generate a list of captions for other report elements. The example identifies the captions to include in the list by associating the captions with the automatic numbering stream that has the name equation. You can use any name for the numbering stream as long as the name matches the value of the AutoNumberStream property of the ListOfCaptions object that represents the list of captions.

Import the DOM and Report API packages so that you do not have to use long, fully qualified class names.

import mlreportgen.dom.*
import mlreportgen.report.*

Create a report.

rpt = Report("My Report","pdf");

Add a table of contents to the report.

toc = TableOfContents;
append(rpt,toc);

Create a list of captions section and add it to the report. Specify that the elements to include in the list are associated with the number stream name equation.

loc = ListOfCaptions();
loc.Title = "List of Equations";
loc.AutoNumberStreamName = "equation";
append(rpt,loc);

Create a chapter and add an equation to the chapter.

ch = Chapter("Physics Principles");
eq = Equation("e = m * c^2");
append(ch,eq);

Create a paragraph for the equation caption.

p = Paragraph("Equation ");

Create an automatic numbering stream with the name equation and associate it with the paragraph.

append(p,AutoNumber("equation"));

Increment the counter for the numbering stream.

p.Style = {HAlign("center"),CounterInc("equation"),WhiteSpace("preserve")};

Append the rest of the caption text to the paragraph and append the paragraph to the chapter. Append the chapter to the report.

append(p,' Mass–energy equivalence');
append(ch,p);
append(rpt,ch);

Close and view the report.

close(rpt);
rptview(rpt);

Here is the list of equations in the report:

Version History

Introduced in R2020b