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

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

DOM API поставляется с шаблонами по умолчанию для каждого типа вывода для форматирования отчета при его создании. Эти шаблоны можно настроить для определения форматирования и формата отчетов по умолчанию. См. раздел Шаблоны для программ отчетов DOM API.

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

Форматировать объекты

Объект форматирования - это объект MATLAB ®, определяющий свойства и функции формата документа, например, семейство шрифтов или размер. DOM API предоставляет набор конструкторов для создания объектов формата, соответствующих большинству параметров форматирования, доступных в документах 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')}];

Эта практика предотвращает непреднамеренное удаление ранее добавленных объектов формата или добавление DOM API для синхронизации 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;

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

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

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

import mlreportgen.dom.*

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