mlreportgen.report. Класс TableOfContents

Пакет: mlreportgen.report
Суперклассы:

Генератор отчетов оглавления

Описание

Создайте генератор отчетов оглавления (TOC), который добавляет оглавление в отчет. Этот класс наследовался mlreportgen.report.Reporter

Конструкция

toc = TableOfContents() возвращает генератор отчетов, который генерирует раздел оглавления (TOC) для отчета. Шаблон по умолчанию для раздела TOC задает внешний вид и макет страницы TOC. Раздел TOC содержит заголовок по умолчанию и элемент TOC, который задает местоположение TOC, который будет сгенерирован, в зависимости от отчета выходной тип. Путь, которым сгенерирован TOC, отличается для каждого типа отчета.

  • HTML — JavaScript, скопированный от шаблона отчета до отчета, генерирует TOC, когда отчет открыт в браузере. Скрипт генерирует TOC как разборное дерево. Древовидные записи являются связанным гиперссылками содержимым элементов заголовка HTML (h1-h6) отчета. Уровень записи в дереве TOC соответствует уровню направляющегося элемента. Глава и генераторы отчетов раздела генерируют главу и разделяют заголовки направляющихся элементов соответствующего уровня, таким образом, глава и разделяет заголовки, появляются автоматически в TOC. Можно также использовать DOM Направляющиеся элементы в отчете сгенерировать Элементы оглавления.

  • DOCX — Функция rptview Генератора отчетов дает Word команду генерировать TOC после того, как это откроет отчет в Word. Если вы открываете отчет в Word непосредственно, не используя rptview, необходимо обновить отчетный документ сами, чтобы сгенерировать TOC.

    TOC является таблицей 2D столбца. Первый столбец содержит связанное гиперссылками содержимое абзацев отчета, уровни схемы которых были установлены. Уровень схемы определяет форматирование Элемента оглавления. Второй столбец содержит количество страницы, на которой происходит соответствующий абзац. Глава и генераторы отчетов раздела генерируют главу и разделяют заголовки абзацев с соответствующим набором уровня, таким образом, глава и разделяет заголовки, появляются автоматически в TOC. Можно также использовать DOM Направляющиеся элементы в отчете сгенерировать Элементы оглавления.

  • PDF — Генератор отчетов использует Форматирование процессора объектов (FOP) Apache™, чтобы сгенерировать TOC как часть генерации документа в формате PDF, FOP генерирует TOC способом, подобным способу, которым Word генерирует TOC для документа Word.

toc = TableOfContents(title) создает TOC, который использует заданный title.

toc = TableOfContents(Name,Value) свойства наборов с помощью пар "имя-значение". Можно задать несколько аргументов пары "имя-значение" в любом порядке. Заключите каждое имя свойства в одинарные кавычки.

Свойства

развернуть все

Заголовок оглавления, заданный как одно из этих значений:

  • Строка или символьный массив

  • Объект DOM

  • 1 N или N-by-1 массив строк или Объектов DOM

  • 1 N или N-by-1 массив ячеек строк, символьных массивов и/или Объектов DOM

  • Генератор отчетов TableOfContentsTitle

Пример: 'TableOfContents','Report Contents'

Объект mlreportgen.dom.TOC. Используйте этот объект в качестве свойства генератора отчетов TableofContents настроить оглавление в вашем отчете. По умолчанию объект DOM TOC создает оглавление максимум с 3 уровнями и с точками как шаблон лидера, который задает символы между главой и именами раздела и их номерами страниц. Настройте TOCObj, чтобы получить, например, различное количество уровней или пробелов как шаблон лидера.

Пример: toc = mlreportgen.report.TableOfContents; toc.TOCObj.NumberOfLevels = 2;

Параметры макета для этого генератора отчетов, заданного, в зависимости от которого свойства макета вы устанавливаете. Свойствами макета является Watermark, FirstPageNumber, PageNumberFormat и Landscape. Смотрите mlreportgen.report.ReporterLayout для описаний этих свойств

Источник шаблона для этого генератора отчетов, заданного как одно из этих значений:

  • Строка или символьный массив, задающий путь файла, содержащего шаблон для этого генератора отчетов

  • Генератор отчетов или отчет, шаблон которого используется в качестве шаблона для этого генератора отчетов или чья библиотека шаблонов содержит шаблон для этого генератора отчетов

  • Документ DOM или часть документа, шаблон которой используется в качестве шаблона для этого генератора отчетов или чья библиотека шаблонов содержит шаблон для этого генератора отчетов

Заданный шаблон должен иметь тот же тип как отчет, к которому добавлен этот генератор отчетов. Например, для отчета Word, TemplateSrc должен быть шаблоном генератора отчетов Word. Если свойство TemplateSrc пусто, этот генератор отчетов использует шаблон генератора отчетов по умолчанию для выходного типа отчета.

Имя шаблона для этого генератора отчетов, заданного как строка или символьный массив. Шаблон для этого генератора отчетов находится в библиотеке шаблонов источника шаблона (TemplateSrc) для этого генератора отчетов.

Цель гиперссылки для этого генератора отчетов, заданного как строка или символьный массив, который задает ID цели ссылки или объект mlreportgen.dom.LinkTarget. Значение строки или символьного массива преобразовано в объект LinkTarget. Объект цели ссылки сразу предшествует содержимому этого генератора отчетов в выходном отчете.

Методы

createTemplate Создайте шаблон раздела оглавления
customizeReporter Создайте пользовательский класс генератора отчетов оглавления
getClassFolderРасположение файла определения класса оглавления
getTitleReporterПолучите генератор отчетов заголовка оглавления

Унаследованные методы

customizeReporterСоздайте класс, выведенный из класса Генератора отчетов
getImpl Получите реализацию генератора отчетов

Копировать семантику

Указатель. Чтобы изучить, как классы Handle влияют на операции копии, смотрите Копирование Объектов (MATLAB).

Примеры

Оглавление по умолчанию

Создайте оглавление, которое использует форматирование по умолчанию.

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

Индивидуально настраиваемое оглавление

Создайте отчет, который включает оглавление с заголовком зеленого цвета. Этот отчет также включает в себя главы, разделы и раздел приложения.

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);

Введенный в R2017b