Сообщите о подходах форматирования

Можно отформатировать отчет с помощью таблиц стилей, объектов формата, свойств формата или любой комбинации этих подходов.

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

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

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

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

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

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

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

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

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

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

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

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

Присвоение значения к свойству формата заставляет API создавать эквивалентный объект формата и присваивать его свойству Style объекта документа. Точно так же присвоение объекта формата к свойству Style объекта заставляет API присваивать эквивалентную стоимость соответствующему свойству формата, если это существует. Таким образом API сохраняет свойства формата для объекта синхронизируемыми со свойством Style объекта.

Примечание

Когда вы изменяете значение свойства формата, API DOM:

  • Создает клон соответствующего объекта формата

  • Изменяет значение соответствующего свойства объекта формата клона

  • Заменяет объект исходного формата на клон в массиве объектов формата, присвоенных объекту документа

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

Связанные примеры

Больше о