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

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

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