Exponenta Banner

mlreportgen.report.TitlePage class

Пакет: mlreportgen.report
Суперклассы:

Генератор отчетов титульного листа

расширьте все на странице

Описание

Создайте генератор отчетов титульного листа, который добавляет титульный лист в отчет. Этот класс наследовался mlreportgen.report.Reporter.

Конструкция

tp = TitlePage() создает объект генератора отчетов титульного листа, который использует шаблон титульного листа по умолчанию. Шаблон титульного листа не включает номер страницы в нижний колонтитул.

tp = TitlePage(Name,Value) свойства наборов с помощью пар "имя-значение". Можно задать несколько аргументов пары "имя-значение" в любом порядке. Заключите каждое имя свойства в одинарные кавычки.

Свойства

развернуть все

Заголовок оглавления, заданный как одно из этих значений:

  • Строка или символьный массив

  • Объект DOM

  • 1 N или N-by-1 массив строк или Объектов DOM

  • 1 N или N-by-1 массив ячеек строк, символьных массивов и/или Объектов DOM

  • TitlePageTitle генератор отчетов

Пример: tp.Title = 'My Report';

Заголовок оглавления, заданный как одно из этих значений:

  • Строка или символьный массив

  • Объект DOM

  • 1 N или N-by-1 массив строк или Объектов DOM

  • 1 N или N-by-1 массив ячеек строк, символьных массивов и/или Объектов DOM

  • TitlePageSubtitle генератор отчетов

Пример: tp.Subtitle = 'Part I';

Отобразите, чтобы вставить в титульный лист, заданный как одно из этих значений:

  • Строка или символьный массив, который задает путь к файловой системе изображения

  • Создайте снимки производителя, такого как mlreportgen.report.Figure генератор отчетов.

  • Объект DOM

  • 1 N или N-by-1 массив ячеек каналов передачи изображения, создайте снимки производителей или Объекты DOM

  • TitlePageImage генератор отчетов

Поддерживаемые форматы изображения:

  • .bmp – Битовый массив

  • .gif – Формат обмена графическими данными

  • .jpg – JPEG

  • .png – Переносимая сетевая графика

  • .emf – Расширенный метафайл (поддерживаемый только в .docx выведите на Windows),

  • .svg – Масштабируемое векторное изображение

  • .tif – Пометьте файл изображения

Пример: tp.Image = 'reports/imagedir/titleimage.jpg';

Сообщите об авторе, заданном как одно из этих значений:

  • Строка или символьный массив

  • Объект DOM

  • 1 N или N-by-1 массив строк или Объектов DOM

  • 1 N или N-by-1 массив ячеек строк, символьных массивов и/или Объектов DOM

  • TitlePageAuthor генератор отчетов

Если имя пользователя переменной окружения не найдено, значение по умолчанию пусто.

Пример: TitlePage('Author','John Smith')

Сообщите об издателе, заданном как одно из этих значений:

  • строка или символьный массив

  • Объект DOM

  • 1 N или N-by-1 массив строк или Объектов DOM

  • 1 N или N-by-1 массив ячеек строк, символьных массивов и/или Объектов DOM

  • TitlePagePublisher генератор отчетов

Пример: tp.Publisher = 'Smith Company';

Сообщите о годе издания, заданном как одно из этих значений:

  • Строка или символьный массив

  • Объект DOM

  • 1 N или N-by-1 массив строк или Объектов DOM

  • 1 N или N-by-1 массив ячеек строк, символьных массивов и/или Объектов DOM

  • TitlePagePublDate генератор отчетов

Пример: tp.PubDate = 'April 23, 2017';

Параметры макета для этого генератора отчетов, заданного, в зависимости от которого свойства макета вы устанавливаете. Свойствами макета является Watermark, FirstPageNumber, PageNumberFormat, и Landscape. Смотрите mlreportgen.report.ReporterLayout для описаний этих свойств

Источник шаблона для этого генератора отчетов, заданного одним из этих способов:

  • Вектор символов или скаляр строки, который задает путь файла, который содержит шаблон для этого генератора отчетов

  • Генератор отчетов или отчет, шаблон которого используется в этом генераторе отчетов или чья библиотека шаблонов содержит шаблон для этого генератора отчетов

  • Документ DOM или часть документа, шаблон которой используется в этом генераторе отчетов или чья библиотека шаблонов содержит шаблон для этого генератора отчетов

Заданный шаблон должен быть тем же типом как отчет, к которому добавлен этот генератор отчетов. Например, для отчета Word Microsoft®, TemplateSrc должен быть шаблон генератора отчетов Word. Если TemplateSrc свойство пусто, этот генератор отчетов использует шаблон генератора отчетов по умолчанию в выходном типе отчета.

Имя шаблона для этого генератора отчетов, заданного как вектор символов или скаляр строки. Шаблон для этого генератора отчетов находится в библиотеке шаблонов источника шаблона (TemplateSrc) для этого генератора отчетов.

Цель гиперссылки для этого генератора отчетов, заданного как строка или символьный массив, который задает ID цели ссылки или mlreportgen.dom.LinkTarget объект. Значение строки или символьного массива преобразовано в LinkTarget объект. Объект цели ссылки сразу предшествует содержимому этого генератора отчетов в выходном отчете.

Методы

createTemplateСоздайте шаблон титульного листа
customizeReporterСоздайте пользовательский класс генератора отчетов титульного листа
getAuthorReporterПолучите генератор отчетов автора титульного листа
getClassFolderРасположение файла определения класса титульного листа
getImageReporter Получите генератор отчетов титульного листа изображений
getPubDateReporterПолучите генератор отчетов года издания титульного листа
getPublisherReporter Получите генератор отчетов издателя титульного листа
getSubtitleReporter Получите генератор отчетов подзаголовка титульного листа
getTitleReporterПолучите генератор отчетов заголовка титульного листа

Унаследованные методы

customizeReporterСоздайте класс, выведенный из класса Генератора отчетов
getImpl Получите реализацию генератора отчетов

Копировать семантику

Указатель. Чтобы изучить, как классы Handle влияют на операции копии, смотрите Копирование Объектов (MATLAB).

Примеры

Титульный лист по умолчанию

Создайте титульный лист, который использует форматирование по умолчанию. Добавьте титульный лист в отчет и просмотрите отчет.

import mlreportgen.report.*
rpt = Report('output','pdf');

tp = TitlePage();
tp.Title = 'Aircraft Tests';
tp.Subtitle = 'Monthly Data';
tp.Image = which('b747.jpg');
tp.Author = 'John Smith';
tp.Publisher = 'MathWorks';
tp.PubDate = date();

add(rpt,tp);
close(rpt);
rptview(rpt);

Титульный лист с индивидуально настраиваемым цветом

Создайте титульный лист, который использует формат заголовка по умолчанию, но изменяет цвет заголовка в красный. В этом случае вы задаете Title свойство как Text DOM возразите и выбранный его цвет к красному.

import mlreportgen.report.*
import mlreportgen.dom.*

rpt = Report('output','pdf');
tp = TitlePage;
tp.Title = Text('Aircraft Tests');
tp.Title.Color = 'red';

add(rpt,tp);
close(rpt);
rptview(rpt);

Замените форматирование заголовка титульного листа

Создайте титульный лист, который заменяет форматирование свойства заголовка. Измените шрифт заголовка в Arial на 24 ПБ, цвет текста заголовка белому, и используйте синий фон. Любые стили, которые вы не задаете, используют mlreportgen.dom.Paragraph значения по умолчанию класса. 

import mlreportgen.report.*
import mlreportgen.dom.*

rpt = Report('output','pdf');
tp = TitlePage();
title = Paragraph('Aircraft Tests');
title.Style = {HAlign('left'),FontFamily('Arial'),...
         FontSize('24pt'),Color('white'),...
         BackgroundColor('blue'),...
         OuterMargin('0in','0in','.5in','1in'),...
         HAlign('center')};
tp.Title = title;
tp.Subtitle = 'Monthly Data';
tp.Image = which('b747.jpg');
tp.Author = 'John Smith';
tp.Publisher = 'MathWorks';
tp.PubDate = date();

add(rpt, tp);
close(rpt);
rptview(rpt);

Замените форматирование титульного листа и размещение Используя шаблоны

Шаблон для TitlePage объект определяет свою ориентацию страницы, поля страницы, размер страницы и другие свойства макета страницы. Можно настроить и заменить размещение титульного листа с помощью настроенной версии его шаблона по умолчанию. Можно также настроить отдельные элементы титульного листа путем настройки тех шаблонов элемента. TitlePage генератор отчетов поддерживает два подхода к переопределяющим шаблонам элемента титульного листа.

Используйте пользовательский шаблон TitlePage

  1. Создайте копию шаблона титульного листа по умолчанию.

  2. Отредактируйте шаблоны элемента титульного листа, как желаемый в копии шаблона. Имена шаблонов имеют форму TitlePageNAME где NAME имя шаблона в библиотеке шаблонов. Например, именем шаблона заголовка является TitlePageTitle.

  3. Установите TitlePage TemplateSrc свойство объекта к пути пользовательского шаблона.

Используйте различную библиотеку шаблонов

Этот подход использует в своих интересах то, что TitlePage возразите использованию специализированные генераторы отчетов, названные генераторами отчетов отверстия, чтобы применить шаблоны элемента к элементам. TitlePage генератор отчетов предоставляет методы для того, чтобы заставлять генератор отчетов применить шаблон к конкретному элементу. Например, getTitleReporter метод возвращает генератор отчетов, используемый в применении TitlePageTitle обработайте по шаблону к содержимому заголовка отчета.

  1. Скопируйте шаблоны элемента титульного листа, которые вы хотите настроить в различную библиотеку шаблонов. Например, можно скопировать библиотеку шаблонов отчета или библиотеку шаблонов объекта части документа DOM. Эти библиотеки шаблонов часто являются библиотеками, которые вы создали, чтобы сохранить настроенные версии шаблонов.

  2. Для каждого элемента титульного листа, который будет настроен, получите его генератор отчетов элемента. Например, для заголовка, используйте getTitleReporter метод.

  3. Установите TemplateSrc свойство генератора отчетов элемента к источнику библиотеки шаблонов, содержащей настроенную версию шаблона элемента.

  4. Установите Content свойство генератора отчетов элемента к содержимому элемента.

  5. Установите свойство элемента объекта титульного листа на объект генератора отчетов элемента.

import mlreportgen.report.*
import mlreportgen.dom.*

rpt = Report('MyReport','pdf','MyCustomPDFTemplate');
tp = TitlePage;
titleReporter = getTitleReporter(tp);
titleReporter.TemplateSrc = rpt;
titleReporter.Content = 'My Report';
tp.Title = titleReporter;

Смотрите также

Темы

Введенный в R2017b

Документация MATLAB Report Generator
Поддержка