В этой ссылке описываются шаблоны, используемые этими репортерами:
Раздел (см. Шаблоны разделов)
Глава (см. Шаблоны главы)
Эта информация используется для создания пользовательских шаблонов для использования с одним из этих репортеров или из репортера, полученного из этих репортеров.
Section reporter использует шесть наборов шаблонов для каждого из трех типов выходных данных, поддерживаемых MATLAB ® Report Generator™: docx, pdf и html. Каждый набор соответствует шести уровням иерархии разделов, которые Section репортер может генерировать. Первый набор соответствует секции верхнего уровня, второй набор соответствует подсекции второго уровня секции верхнего уровня и так далее.
Каждый набор уровней содержит три шаблона:
Шаблон тела раздела под названием SectionN, где N - уровень раздела (см. Шаблон Section1 и Section2 - Шаблоны Section6).
Шаблон заголовка пронумерованного раздела с именем SureNumberedStartN (см. Шаблоны заголовка пронумерованного раздела).
Шаблон заголовка раздела без нумерации имеет имя SureGroupN (см. раздел Шаблоны заголовка раздела без нумерации).
A Section reporter определяет, какой набор будет использоваться при добавлении reporter к объекту отчета. Например, когда программа отчетов добавляет Section reporter к объекту Report, Section reporter использует набор шаблонов верхнего уровня. A Section reporter использует набор шаблонов второго уровня, когда метод добавления отчета добавляет его в отчет как часть содержимого репортера раздела верхнего уровня. A Section reporter использует набор шаблонов третьего уровня, когда метод добавления отчета добавляет его в отчет как часть содержимого reporter второго уровня и т.д.
Section шаблоны Section1 Word, PDF и HTML репортера определяют формат раздела верхнего уровня, созданного репортером раздела 1 в отчете Word, PDF и HTML, соответственно. Все три шаблона определяют расположение отверстий и стили по умолчанию для Section репортерская Title и Content свойства.
Кроме того, шаблоны PDF и Word определяют свойства макета страницы раздела верхнего уровня, включая ориентацию страницы, поля, заголовки и нижние колонтитулы страницы раздела верхнего уровня Word или PDF. Шаблоны Word и PDF указывают другой заголовок для первой страницы раздела и для следующих страниц. Заголовок первой страницы содержит только правило. Заголовок последующих страниц, называемый заголовком по умолчанию, содержит заголовок раздела. Нижний колонтитул первой страницы и последующие нижние колонтитулы страницы идентичны.
Раздел верхнего уровня запускается на новой странице со свойствами, заданными верхним уровнем Section шаблон репортера. Все последующие страницы, необходимые для размещения содержимого раздела верхнего уровня, имеют одинаковый макет страницы, если только сам контент не указывает новый макет страницы, в этом случае макет страницы последующих страниц изменяется. Шаблоны разделов нижнего уровня по умолчанию не указывают макет страницы. В результате добавление подразделов в раздел не изменяет макет страницы. Содержимое подразделов имеет тот же макет, что и разделы верхнего уровня.
Шаблон Section1 Word
Шаблон Word Section1 находится в галерее QuickParts Section репортерская default.dotx файл шаблона. Галерея QuickParts служит в качестве Section библиотека шаблонов Word репортера. Чтобы просмотреть или изменить шаблон Section1, необходимо открыть default.dotx в Word и создайте экземпляр шаблона в default.dotx шаблон. Шаблон Section1 отображается в Word следующим образом:
Примечание
При отображении копии шаблона Word Section1 он прокручивается до заголовка страницы по умолчанию на второй странице, на которой отображается сообщение об ошибке. Объяснение этого сообщения об ошибке см. в примечании ниже. Чтобы увидеть отверстия шаблона, прокрутите его вверх.
Шаблон раздела 1 определяет заголовок для первой страницы раздела, который отличается от заголовка последующих страниц. Заголовок всех страниц, кроме первой, называется заголовком по умолчанию. Заголовок первой страницы содержит правило, но в противном случае пуст.
Примечание
Правило реализуется как пустой абзац с нижней границей. Размер шрифта абзаца устанавливается на очень низкое значение, чтобы минимизировать высоту абзаца.
Нижний колонтитул первой страницы содержит поле Номер страницы Word. Когда этот шаблон или отчет, созданный на его основе, открывается в Word, Word заменяет поле номером страницы, на которой отображается нижний колонтитул.
Заголовок страницы Section1 по умолчанию содержит поле Word StyleRef, которое ссылается на стиль заголовка раздела (то есть SureTitle). Когда шаблон или отчет, созданный из шаблона, открывается в Word, Word заменяет поле StyleRef содержимым первого абзаца в разделе со стилем SureTitle. В докладе этот пункт содержит название раздела. Таким образом, заголовок раздела отображается в заголовках страниц, следующих за первой страницей. (Это называется бегущей головкой в дизайне документа.)
Примечание
Шаблон Section1 занимает менее страницы. Таким образом, при копировании шаблона Section1 из галереи QuickPart репортера раздела (то есть библиотеки шаблонов) в тело default.dotx шаблон, появляется только первая страница раздела. Однако Word создает страницу с новым разделом (раздел 2), который наследует заголовки страниц шаблона Section1. Word заменяет поле StyleRef в заголовке этого нового раздела сообщением об ошибке, поскольку в новом разделе нет абзаца со стилем ссылки.
Шаблон Section1 задает нижний колонтитул страницы по умолчанию, идентичный по содержанию и формату первому нижнему колонтитулу страницы.
Примечание
Чтобы просмотреть или изменить нижний колонтитул страницы по умолчанию, необходимо вставить страницу в шаблон Section1 следующим образом:
Скопируйте шаблон из Section галерея QuickParts шаблона репортера (то есть его библиотека шаблонов) в тело шаблона репортера.
Вставка абзаца после отверстия «Содержимое» в шаблоне.
Включить абзац Page Break Before собственность.
Шаблон Section1 PDF
Шаблон PDF- Section1 находится в библиотеке шаблонов файла PDF-шаблона репортера раздела (default.pdftx). Файл шаблона является zip-файлом. Библиотека шаблонов хранится в файле с именем docpart_templates.html. Чтобы просмотреть или изменить шаблон Section1, выполните следующие действия.
Распакуйте копию default.pdftx файл с помощью API отчетов unzipTemplate команда.
Откройте окно docpart_templates.html в редакторе MATLAB или любом другом текстовом редакторе.
По завершении редактирования шаблона Section1 сохраните docpart_templates.html файл.
Создать резервную копию default.pdftx файл, с помощью API отчетов zipTemplate команда.
Дополнительные сведения см. в разделе Создание библиотеки шаблонов деталей PDF-документа.
Шаблон Section1 PDF использует следующую разметку HTML для определения макета страницы раздела PDF верхнего уровня, созданного Section репортер. Разметка также определяет расположение отверстий, которые должны быть заполнены содержимым Section репортерская Title и Content свойства.
Элементы feader и pfooter в макете Section1 определяют шаблоны, используемые для определения содержимого и макета колонтитулов страниц раздела верхнего уровня. Шаблоны верхнего и нижнего колонтитулов находятся в одном файле библиотеки шаблонов (docpart_templates.html) в качестве самого шаблона Section1. Section reporter использует только шаблоны первой страницы и страницы по умолчанию.
Шаблоны колонтитулов первой страницы:
Шаблон заголовка указывает пустой абзац, за которым следует горизонтальное правило. В пустом абзаце указан стиль SureGroupHead. Он определен в таблице стилей шаблона (см. ниже). Шаблон нижнего колонтитула первой страницы задает горизонтальное правило, за которым следует номер страницы.
Шаблон заголовка страницы по умолчанию
задает абзац, содержащий стилереф, за которым следует горизонтальное правило. Во время создания отчета API Report заменяет элемент styleref содержимым заголовка раздела верхнего уровня, создавая тем самым рабочую головку.
Шаблон нижнего колонтитула страницы по умолчанию
задает горизонтальное правило, за которым следует автоматически сгенерированный номер страницы.
Стили для шаблонов верхнего и нижнего колонтитулов находятся в pdf/stylesheets/root.css файл.
Шаблон Section1 HTML
Шаблон детали Section1 документа в default.htmt в файле указываются отверстия «Заголовок» и «Содержимое».
Шаблоны Section2-Section6 определяют формат подразделов, созданных Section репортер. Каждый шаблон содержит элементы отверстий, которые определяют расположение отверстий, заполняемых содержимым репортера секции. Title и Content соответственно. Отверстие заголовка в каждом шаблоне определяет стиль заголовка по умолчанию для уровня подраздела, определенного шаблоном.
Word Section2 - шаблоны Section6
Например, на этом рисунке показан шаблон Section2.
PDF и HTML Section2 - шаблоны Section6
Например, на этом рисунке показан шаблон Section2.
Все шаблоны сечений (Section1 - Section6) имеют отверстия, описанные в этой таблице.
| Идентификатор удержания | Тип отверстия | Описание |
|---|---|---|
Название | Блок |
|
Содержание | Блок | Содержание раздела |
Шаблоны сечений используют стили для форматирования некоторых компонентов. Шаблоны Word определяют стили, которые они используют в таблице стилей в default.dotx файл шаблона. Шаблоны PDF и HTML определяют стили в stylesheets/root.css в файле default.pdftx и default.htmt файлы, соответственно. В следующей таблице описаны стили, используемые шаблонами сечений.
| Имя стиля | Тип стиля | Описание |
|---|---|---|
SectionContent | Характер | Отверстие «Содержимое» в шаблонах Section1-Section6 задает этот стиль в качестве текстового стиля по умолчанию для содержимого, заполняющего отверстие. Содержимое может задавать стили или форматы, которые переопределяют стиль по умолчанию. |
SectionTitle1 - SectionTitle6 | Характер | Отверстие заголовка в соответствующем шаблоне сечения определяет соответствующее имя стиля в качестве стиля по умолчанию для заголовка сечения. Например, отверстие заголовка в шаблоне Section1 задает SectionTitle1 в качестве имени стиля по умолчанию для заголовка сечения верхнего уровня. Содержимое, добавляемое в отверстие заголовка, может задавать форматы или стили, которые переопределяют стиль по умолчанию. |
SectionTitleHeader | Характер | Этот стиль используется в заголовках Section1 страниц для центрирования содержимого заголовка. |
SectionTitleFooter | Характер | Нижний колонтитул Section1 страницы использует этот стиль для содержимого нижнего колонтитула. |
Если содержание репортера Секции Title свойство представляет собой строку, текст или другой встроенный объект, в котором используется SectionTitle для создания содержимого, используемого для заполнения отверстия заголовка в шаблонах уровня сечения. SectionTitle reporter, в свою очередь, использует шаблоны для форматирования встроенного содержимого в качестве заголовка. SectionTitle reporter использует два набора шаблонов для каждого типа вывода, один для создания иерархически нумерованных заголовков (1.1, 1.2, 1.2.1 и так далее), другой для создания ненумерованных заголовков. Каждый набор содержит шесть шаблонов, соответствующих шести уровням разделов, которые Section репортер может генерировать. Шаблоны находятся в библиотеках шаблонов файлов Word, PDF и HTML репортера разделов. default.dotx, default.pdftx, и default.htmtсоответственно.
Если отчет или Section reporter указывает, что его названия должны быть пронумерованы, SectionTitle reporter использует автоматически пронумерованные шаблоны для форматирования встроенного содержимого Section репортерская Title собственность. Заголовки имеют имя SureNumberedStartN, где N - уровень раздела, к которому применяется шаблон. Например, SectionNumberedTitle1 имя шаблона для заголовка раздела верхнего уровня. Каждый шаблон содержит элемент абзаца, который задает тот же стиль, что и отверстие заголовка в соответствующем шаблоне уровня сечения, например, SectionTitle1 для заголовка сечения верхнего уровня. См. раздел Стили шаблонов сечений.
Заголовок параграфа содержит следующие отверстия.
Отверстие NumberPrefix, заполняемое содержимым SectionTitle репортерская NumberPrefix свойство (по умолчанию пустое)
Автоматическая разметка номеров, заменяемая иерархическим номером во время создания отчета. Автоматическая нумерация разметки различается для каждого шаблона уровня, чтобы генерировать иерархический номер, соответствующий этому уровню.
Отверстие NumberSuffix, заполняемое содержимым SectionTitle репортерская NumberSuffix свойство (по умолчанию пустое).
Отверстие содержимого, заполняемое содержимым SectionTitle репортерская Content собственность.
На следующих рисунках показаны шаблоны SectionNumberedTitle1 Word, PDF и HTML соответственно. Шаблоны нижнего уровня аналогичны.
Шаблон SectionNumberedTitle1 Word
Шаблон SectionNumberedTitle1 PDF
Шаблон SectionNumberedTitle1 HTML
Во время формирования отчета Section репортер устанавливает Content имущества SectionTitle репортер о встроенном содержимом Section репортерская Title собственность. Он не устанавливает NumberPrefix и NumberSuffix свойства. В результате заголовок, сгенерированный SectionTitle по умолчанию репортер состоит из иерархического номера, за которым следует текст заголовка.
SectionTitle reporter предоставляет отверстия NumberPrefix и NumberSuffix для упрощения маркировки заголовков производными репортерами. Например, Chapter репортер, который получен из Section репортер, устанавливает NumberPrefix property to Chapter на английском языке. В некоторых восточноазиатских регионах Chapter репортер устанавливает NumberSuffix в главу обозначения символов.
Примечание
Если вы настраиваете нумерованный шаблон сечения, не удаляйте и не заменяйте поля SEQ в шаблоне Word или автонумерации в шаблоне PDF или HTML. Для создания ненумерованных сечений используйте шаблоны заголовков ненумерованных сечений.
Все шаблоны SureNumberedTitle (Section1 - Section6) имеют отверстия, описанные в этой таблице.
| Идентификатор отверстия | Тип отверстия | Описание |
|---|---|---|
NumberPrefix | Действующий | Префикс, отображаемый перед номером раздела. |
NumberSuffix | Действующий | Суффикс, отображаемый после номера сечения. |
Содержание | Действующий | Содержание названия |
Если в отчете указано, что в текущем разделе используются ненумерованные заголовки, SectionTitle reporter использует ненумерованные шаблоны для создания заголовков разделов. Ненумерованные шаблоны имеют имя SureGroupN, где N - уровень раздела, заголовок которого должен быть создан. Например, шаблон для секции верхнего уровня называется SectionTitle1. Каждый шаблон содержит элемент абзаца, который задает тот же стиль, что и отверстие заголовка в соответствующем шаблоне уровня сечения, например, SectionTitle1, для заголовка сечения верхнего уровня. См. раздел Стили шаблонов сечений. Заголовок параграфа содержит отверстие, которое должно быть заполнено содержимым SureReporter Content свойство (устанавливается Section репортер при формировании отчета).
На следующих рисунках показаны версии шаблонов SectionTitle1 Word, PDF и HTML. Шаблоны нижнего уровня аналогичны.
Шаблон заголовка раздела Word
Все уровни шаблонов Word SureTitle имеют одно и то же отверстие содержимого.
Шаблон SectionTitle1 PDF и HTML
PDF и HTML SectionTitle2 - шаблоны SectionTitle6
Эти шаблоны заголовков сечений включают отверстие «Содержимое», как в SectionTitle1 шаблоне. Каждый из этих разделов определяет стиль заголовка.
Все шаблоны SureTitle (Section1 - Section6) содержат отверстие, описанное в этой таблице.
| Идентификатор отверстия | Тип отверстия | Описание |
|---|---|---|
Содержание | Действующий | Содержание названия |
Chapter reporter, подкласс Section репортер, использует Section набор шаблонов верхнего уровня репортера для создания его содержимого. Это происходит потому, что раздел, созданный главой, почти идентичен разделу, созданному секцией. Однако два типа разделов различаются в двух отношениях:
Заголовок раздела главы содержит слово Глава на английском языке или эквивалент на других языках, поддерживаемых API Report. Chapter репортер включает слово Глава в заголовки, установив NumberPrefix или NumberSuffix свойства SectionTitle reporter, используемый для создания заголовка главы.
Все разделы верхнего уровня, созданные в разделе, начинаются на странице 1. Напротив, только первая глава, сгенерированная Chapter репортер начинается на странице 1. Последующие главы продолжают нумерацию страниц из предыдущей главы. Chapter reporter реализует это поведение программно, тем самым избегая необходимости использования модифицированной версии шаблона верхнего уровня раздела.
См. разделы «Шаблон Section1», «Шаблоны заголовков нумерованных сечений» и «Шаблоны заголовков ненумерованных сечений»