mlreportgen.dom. Класс TOC

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

Создайте заполнителя для генерации оглавления

Описание

Создайте заполнителя для оглавления документа. Когда сгенерированный документ Word открывается, Word заменяет заполнителя на TOC, который это генерирует. Точно так же, когда сгенерированный документ HTML открывает в браузере HTML, браузер заменяет заполнителя на TOC, который это генерирует. Для PDF API DOM заменяет заполнителя на TOC, который это генерирует при выводе документа.

Во всех случаях Элементы оглавления состоят из содержимого абзацев с помощью количества направляющихся уровней, которые вы задаете. Для PDF и Word, заполнитель TOC также задает лидера, который заполняет пробел между содержимым и номером страницы в Элементе оглавления.

Конструкция

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

toc = TOC(levels) использует конкретное количество направляющихся уровней.

toc = TOC(levels,leader) использует заданного лидера.

Входные параметры

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

Количество направляющихся уровней, чтобы использовать в TOC, заданном как положительное целое число.

Тип лидера, чтобы использовать между заголовком и номером страницы, заданным как '.' (т.е. период или точка) или ' ' (пробел).

Выходные аргументы

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

Оглавление, возвращенное как объект mlreportgen.dom.TOC.

Свойства

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

Этот дочерний элемент списков свойств только для чтения элементы этого объекта.

Пользовательские атрибуты этого элемента, указанного как массив объектов mlreportgen.dom.CustomAttribute. Используйте пользовательские атрибуты, поддержанные выходным форматом.

ID для этого элемента документа, указанного как вектор символов. DOM генерирует уникальный идентификатор сеанса, когда он создает элемент документа. Можно задать собственный ID.

Тип лидера, чтобы использовать между заголовком и номером страницы, заданным как '.' (т.е. период или точка) или.' ' (пробел).

Количество направляющихся уровней, чтобы использовать в TOC, заданном как положительное целое число.

Это списки свойств только для чтения родительский элемент этого элемента документа.

Объекты формата, которые задают формат элемента документа.

Имя стиля, чтобы применяться из таблицы стилей, заданной как вектор символов.

Пометьте для элемента документа, указанного как вектор символов.

Уникальный идентификатор сеанса сгенерирован как часть создания элемента документа. Сгенерированный тег имеет форму CLASS:ID, где CLASS является классом элемента, и ID является значением свойства Id объекта. Можно задать тег, чтобы заменить сгенерированный тег.

Например, чтобы облегчить идентифицировать, где проблема произошла во время генерации документов, можно задать собственное значение тега.

Примеры

свернуть все

Этот пример добавляет оглавление в документ с помощью объекта TOC. Этот документ содержит три уровня голов — |Heading1 |, Heading2 и Heading3. Поскольку объект TOC задает только два направляющихся уровня, Heading3 не включен в TOC. Лидер является пробелом.

import mlreportgen.dom.*;
d = Document('mydoc','pdf');
open(d);

title = append(d, Paragraph('My TOC Document'));
title.Bold = true;
title.FontSize = '28pt';

toc = append(d,TOC(2,' '));
toc.Style = {PageBreakBefore(true)};

h1 = append(d,Heading1('Chapter 1'));
h1.Style = {PageBreakBefore(true)};
p1 = append(d,Paragraph('Hello World'));

h2 = append(d,Heading2('Section 1.1'));
h2.Style = {PageBreakBefore(true)};
p2 = append(d,Paragraph('Another page'));

h3 = append(d,Heading3('My Subsection 1.1.a'));
p3 = append(d, Paragraph('My Level 3 Heading Text'));

close(d);
rptview(d.OutputPath);

Введенный в R2016a