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

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

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

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 предотвращает изменение в свойстве формата в одном объекте от изменения стиля, первоначально присвоенного другим объектам.

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

Больше о