slreportgen.report.DocBlock class

Пакет: slreportgen.report

Генератор отчетов DocBlock

Описание

Создает генератор отчетов DocBlock.

Примечание

Чтобы использовать генератор отчетов DocBlock в отчете, необходимо создать отчет с помощью slreportgen.report.Report класс или подкласс.

Генератор отчетов добавляет содержимое DocBlock или ссылку на содержимое к отчету, в зависимости от типа содержимого в DocBlock и типа отчета. Для Microsoft® Word и отчеты PDF, когда DocBlock содержит HTML, можно указать, что генератор отчетов соединяется с содержимым путем установки ConvertHTML свойство к true. Эта таблица показывает, когда отчет включает в себя содержимое и когда это соединяется с содержимым.

Тип контента DocBlockСообщите о типеСвойство ConvertHTMLОтчет содержит содержимое DocBlockОтчет содержит ссылку на содержимое DocBlock
текстHTMLНет данныхданет
текстWordНет данныхданет
текстPDFНет данныхданет
HTMLHTMLНет данныхданет
HTMLWordtRUEданет
HTMLWordложьнетда
HTMLPDFtRUEданет
HTMLPDFложьнетда
RTFWordНет данныхданет
RTFPDFНет данныхнетда
RTFHTMLНет данныхнетда

slreportgen.report.DocBlock классом является handle класс.

Атрибуты класса

HandleCompatible
true

Для получения информации об атрибутах класса см. Атрибуты класса (MATLAB).

Создание

Описание

rptr = slreportgen.report.DocBlock() создает пустой генератор отчетов DocBlock на основе шаблона по умолчанию. Настройте содержимое и формат сгенерированного содержимого при помощи свойств генератора отчетов. Прежде чем вы добавите генератор отчетов в отчет, необходимо задать DocBlock в Свойстве объекта генератора отчетов. Добавление пустого генератора отчетов к отчету производит ошибку.

пример

rptr = slreportgen.report.DocBlock(docBlockObj) создает генератор отчетов DocBlock для DocBlock, заданного docBlockObj, который может быть путем DocBlock или указателем. Смотрите Свойство объекта.

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

Свойства

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

Блок Simulink DocBlock, заданный как скаляр строки или вектор символов, который содержит путь к DocBlock или как указатель на блок DocBlock.

Примечание

Если вы используете средство поиска, чтобы найти блоки DocBlock и добавить результаты непосредственно в отчет, генераторы отчетов DocBlock используются, чтобы сообщить относительно блоков DocBlock, а не генераторов отчетов свойства объекта Simulink.

Импортировать ли содержимое простого текста в линии, заданной как true или false. Если ImportTextInline false, прежде чем генератор отчетов добавляет содержимое к отверстию, это переносит содержимое в один или несколько абзацев, в зависимости от значения TexSep свойство. Установите ImportTextInline к true добавлять текстовое содержимое DocBlock к отверстию в абзаце (встроенное отверстие).

Диафрагма раньше разграничивала абзацы в содержимом простого текста, заданном как одно из значений в таблице. Можно задать значение как скаляр строки или вектор символов.

ЗначениеОписание
"Ignore"Сверните текст в одиночном абзаце независимо от того, содержит ли он диафрагмы. (значение по умолчанию)
"LineFeed"Если текстовый сегмент заканчивается переводом строки, перенесите его в абзац.
"BlankLine"Если текстовый сегмент заканчивается пустой строкой, перенесите его в абзац.

ConvertHTML применяется только к отчетам PDF и Word. Если ConvertHTML true, Содержимое HTML преобразовано в Объекты DOM и добавлено к отчету. Если ConvertHTML false, Содержимое HTML сохранено в файле, и ссылка на файл добавлена к отчету. Если отчет является HTML или отчетом файла HTML, содержимое HTML включено в отчет, независимо от значения ConvertHTML.

Объект средства форматирования абзаца, который форматирует простой текст если ImportTextInline свойством является false, заданный как mlreportgen.dom.Paragraph объект. Начальное значение ParagraphFormatter свойством является mlreportgen.dom.Paragraph со значениями свойств по умолчанию. Чтобы настроить внешний вид абзаца, измените mlreportgen.dom.Paragraph свойства объектов или замена объект с индивидуально настраиваемым mlreportgen.dom.Paragraph объект. Если вы добавляете содержимое в значение по умолчанию или заменяющий объект абзаца, содержимое появляется перед содержимым DocBlock в сгенерированном отчете.

Текстовый объект средства форматирования, который форматирует простой текст если ImportTextInline свойством является true, заданный как mlreportgen.dom.Text объект. Начальное значение TextFormatter свойством является mlreportgen.dom.Text со значениями свойств по умолчанию. Чтобы настроить внешний вид текста, измените mlreportgen.dom.Text свойства объектов или замена объект с индивидуально настраиваемым mlreportgen.dom.Text объект. Если вы добавляете содержимое в значение по умолчанию или заменяющий объект абзаца, содержимое появляется перед содержимым DocBlock в сгенерированном отчете.

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

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

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

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

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

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

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

Методы

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

Примеры

свернуть все

Включайте содержимое от Sensor Info DocBlock sldemo_fuelsys модель в отчете путем добавления DocBlock генератор отчетов к отчету. Укажите, что абзацы в DocBlock разграничены переводом строки.

% Import the API package
import slreportgen.report.*
import mlreportgen.report.*

% Load the model
model_name = 'sldemo_fuelsys';
load_system(model_name);
docBlock = 'sldemo_fuelsys/To Controller/Sensor Info';

% Create a report 
rpt = slreportgen.report.Report('output','pdf');

% Create a chapter reporter
chapter = Chapter(docBlock);

% Create a DocBlock reporter
% Specify that paragraphs are delimited by a linefeed 
rptr = DocBlock(docBlock);
rptr.TextSep = 'LineFeed';

% Add the DocBlock reporter to the chapter
% Add the chapter to the report
add(chapter, rptr);
add(rpt, chapter);

% Close and view the output report
close(rpt);
close_system(model_name);
rptview(rpt);

Вот содержимое от Sensor Info DocBlock in the generated report:

Введенный в R2019b