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

  • Генератор отчетов создается getTitleReporter метод этого титульного листа

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

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

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

  • Объект DOM

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

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

  • Генератор отчетов создается getSubtitleReporter метод этого титульного листа

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

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

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

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

  • Объект DOM

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

  • Генератор отчетов создается getImageReporter метод этого титульного листа

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

  • .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

  • Генератор отчетов создается getAuthorReporter метод этого титульного листа

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

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

Сообщите об издателе в виде одного из этих значений:

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

  • Объект DOM

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

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

  • Генератор отчетов создается getPublisherReporter метод этого титульного листа

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

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

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

  • Объект DOM

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

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

  • Генератор отчетов создается getPubDateReporter метод этого титульного листа

Пример: 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Получите генератор отчетов заголовка титульного листа

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

копия Создайте копию генератора отчетов, возражают и делают глубокие копии значений свойств, которые ссылаются на генератор отчетов, ReporterLayout или Объект DOM
customizeReporterСоздайте класс, выведенный из класса Генератора отчетов
getImpl Получите реализацию генератора отчетов

Примеры

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

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

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

Поддержка

Для просмотра документации необходимо авторизоваться на сайте