mlreportgen.report.TableOfContents class

Package: mlreportgen.report
Superclasses:

Table of contents reporter

Description

Create a table of contents (TOC) reporter that adds a table of contents to the report. This class inherits from mlreportgen.report.Reporter

Construction

toc = TableOfContents() returns a reporter that generates a table of contents (TOC) section for the report. The default template for the TOC section defines the appearance and page layout of the TOC. The TOC section contains a default title and a TOC element that specifies the location of a TOC to be generated, depending on the report output type. The way in which the TOC is generated differs for each report type.

• HTML — A JavaScript copied from the report template to the report generates the TOC when the report is opened in a browser. The script generates the TOC as a collapsible tree. The tree entries are the hyperlinked contents of the HTML heading elements (h1-h6) of the report. The level of an entry in the TOC tree corresponds to the level of the heading element. Chapter and section reporters generate chapter and section titles as heading elements of the appropriate level, so chapter and section titles appear automatically in the TOC. You can also use DOM Heading elements in a report to generate TOC entries.

• DOCX — The Report Generator rptview function instructs Word to generate the TOC after it opens the report in Word. If you open a report in Word directly, without using rptview, you must update the report document yourself to generate the TOC. See Update a Table of Contents or Generated List in a Word Document.

  The TOC is a two-column table. The first column contains the hyperlinked contents of report paragraphs whose outline levels have been set. The outline level determines the formatting of a TOC entry. The second column contains the number of the page on which the corresponding paragraph occurs. Chapter and section reporters generate chapter and section titles as paragraphs with the appropriate level set, so chapter and section titles appear automatically in the TOC. You can also use DOM Heading elements in a report to generate TOC entries.

• PDF — The table of contents is generated during PDF document generation.

toc = TableOfContents(title) creates a TOC that uses the specified title.

toc = TableOfContents(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 quotes.

Properties

Title — Table of contents title

Table of Contents (default) | string | character array | ...

Table of contents title, specified as one of these values:

• String or character array

• DOM object

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

• 1-by-N or N-by-1 cell array of strings, character arrays, and/or DOM objects

• TableOfContentsTitle reporter

Example: 'TableOfContents','Report Contents'

TOCObj — DOM TOC object

DOM TOC object

mlreportgen.dom.TOC object. Use this object as a property of the TableofContents reporter to customize the table of contents in your report. By default, the DOM TOC object creates a table of contents with up to 3 levels and with dots as the leader pattern, which defines the characters between the chapter and section names and their page numbers. Customize the TOCObj to obtain, for example, a different number of levels or spaces as the leader pattern.

Example: toc = mlreportgen.report.TableOfContents; toc.TOCObj.NumberOfLevels = 2;

Layout — Layout options for this reporter

string | character array | ...

Layout options for this reporter, specified depending on which layout property you set. The layout properties are Watermark, FirstPageNumber, PageNumberFormat, and Landscape. See mlreportgen.report.ReporterLayout for descriptions of these properties

TemplateSrc — Source of template for this reporter

[] (default) | 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 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 specified template must be the same type as the report to which this reporter is appended. 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.

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 source (TemplateSrc) for this reporter.

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 is converted to a LinkTarget object. The link target immediately precedes the content of this reporter in the output report.

Methods

createTemplate	Create table of contents section template
customizeReporter	Create custom table of contents reporter class
getClassFolder	Table of contents class definition file location
getTitleReporter	Get table of contents title reporter

Inherited Methods

copy	Create copy of reporter object and make deep copies of property values that reference a reporter, ReporterLayout, or DOM object
customizeReporter	Create class derived from Reporter class
getImpl	Get implementation of reporter

Examples

Default Table of Contents

Create a table of contents that uses the default formatting.

import mlreportgen.report.*
rpt = Report('output','pdf');
toc = TableOfContents();
add(rpt,toc);

Customized Table of Contents

Create a report that includes a table of contents with a title in green. This report also includes chapters, sections, and an appendix section.

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

rpt = Report('Report with TOC');
add(rpt, TitlePage('Title','Report','Subtitle','with TOC'));
toc = TableOfContents;
toc.Title = Text('Table of Contents');
toc.Title.Color = 'green';
toc.TOCObj.NumberOfLevels = 2; 
add(rpt,toc);

ch = Chapter('First Chapter');
add(ch,Section('First Subsection'));
add(ch,Section('Second Subsection'));

add(rpt,ch);
add(rpt,Chapter('Second Chapter'));

add(rpt,PDFPageLayout);
p = Paragraph('Appendix'); 
p.Style = {OutlineLevel(1), Bold, FontSize('18pt')};
add(rpt,p);

close(rpt);
rptview(rpt);