Документация

Таблицы стилей в шаблонах

API DOM идет с шаблонами по умолчанию для каждого выходного типа для форматирования вашего отчета, как это генерирует. Можно настроить эти шаблоны, чтобы задать форматирование по умолчанию и размещение отчетов. Смотрите Шаблоны для Программ Отчета API DOM.

Используйте таблицы стилей в шаблоне, чтобы описать форматирование по умолчанию объектов документа как абзацы, заголовки и таблицы. Таблица стилей является набором стилей форматирования. Стиль является именованным набором форматов для конкретного типа объекта или, в случае HTML и PDF, для конкретного типа объекта, который появляется в конкретном контексте в вашем документе. Например, можно задать стиль абзаца MyPara это использует один набор форматов, таких как размер шрифта, акцент и семейство шрифтов. Вы задаете другой стиль абзаца под названием YourPara это использует различный набор форматов. Когда вы написали свою программу отчета, вы присваиваете стиль объекту абзаца по наименованию. Для примера см. таблицу стилей Использования Стили.

Объекты формата

Объект формата является объектом MATLAB^®, который задает свойства и функции формата документа, такие как семейство шрифтов или размер. API DOM обеспечивает группу конструкторов для создания объектов формата, соответствующих большинству параметров форматирования, доступных в HTML, Word и документах в формате PDF. Большинство объектов документа DOM включает Style свойство, которое можно установить на массив ячеек объектов формата. Можно использовать объекты формата с объектом документа Style свойство отформатировать объект. Например, этот код использует объекты формата, чтобы задать стиль абзаца предупреждения.

import mlreportgen.dom.*

p = Paragraph('Danger!');
p.Style = {Color('red'),FontFamily('Arial'),FontSize('18pt')};

Это - лучшая практика установить Style свойство путем конкатенации существующего значения Style свойство и массив ячеек объектов формата, которые вы добавляете. Например:

import mlreportgen.dom.*

p = Paragraph('Danger!');
p.Style = [p.Style {Color('red'),FontFamily('Arial'),FontSize('18pt')}];

Эта практика предотвращает непреднамеренное удаление объектов формата, которые вы ранее добавили или что API DOM, добавленный, чтобы синхронизировать Style свойство со свойствами формата. Смотрите Свойства формата.

Можно присвоить тот же массив объектов формата больше чем к одному объекту документа DOM. Этот метод позволяет вам создавать программируемый эквивалент листа стиля шаблонов. Например:

import mlreportgen.dom.*

warning = {Color('red'),FontFamily('Arial'),FontSize('18pt')};
p = Paragraph('Danger!');
p.Style = [p.Style warning];
p = Paragraph('Caution!');
p.Style = warning;

API DOM позволяет вам присваивать любой объект формата любому объекту документа, независимо от того, применяется ли формат. Если формат не применяется, он проигнорирован.

Свойства формата

Большинство Объектов DOM имеет набор свойств, соответствующих параметрам формата, обычно используемым в объекте того класса. Например, это кодовые наборы шрифт и цвет текста в абзаце, с помощью Color, FontFamily, и FontSize свойства формата Paragraph объект.

import mlreportgen.dom.*

p = Paragraph('Danger!');
p.Color = 'red';
p.FontFamilyName = 'Arial';
p.FontSize = '18pt';