Exponenta Banner

mlreportgen.dom.DocumentPart class

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

Создайте объект части документа

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

Описание

Задайте часть документа, повторяемую часть отчета. Часть документа обычно имеет отверстия, которые вы заполняете во время генерации отчета. Можно добавить часть к документу или к части документа того же выходного типа.

Конструкция

documentPartObj = DocumentPart() создает часть документа HTML с помощью шаблона HTML по умолчанию.

documentPart = DocumentPart(type) создает часть документа заданного типа (например, Microsoft® Word) на основе шаблона по умолчанию для той части.

documentPartObj = DocumentPart(type,templatePath) создает часть документа на основе заданного шаблона.

documentPartObj = DocumentPart(type,templatePath,docPartTemplateName) создает часть документа на основе заданного шаблона части документа в заданном шаблоне.

documentPartObj = DocumentPart(templateSrc,docPartTemplateName) создает часть документа на основе заданного шаблона части документа, сохраненного в шаблоне, используемом заданным источником. Источник может быть документом или частью документа.

Входные параметры

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

Тип выхода, заданного как одно из этих значений:

  • 'html'— Вывод HTML

  • 'pdf'— PDF на основе шаблона PDF

  • 'docx'— Word выход

  • 'html-file'— Вывод HTML, с помощью одного файла, который содержит CSS, JavaScript®, и отображает для отчета

Если вы задаете шаблон с помощью templatePath аргумент, значение для type должен совпадать с типом шаблона.

Полный путь файла шаблона этой части или папки, заданной как вектор символов. Если вы не используете расширение файла, тип шаблона основан на типе документа, например, .docx для Word.

Типы данных: char

Часть документа обрабатывает по шаблону имя, заданное как вектор символов. Задайте, где часть хранится с помощью templatePath или templateSrc аргумент.

Документ или часть документа возражают, чей шаблон содержит шаблон для этой части документа, заданной как mlreportgen.dom.Document объект для документа или mlreportgen.dom.DocumentPart объект для части документа.

Выходные аргументы

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

Часть документа, возвращенная как mlreportgen.dom.DocumentPart объект.

Свойства

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

Этот дочерний элемент списков свойств только для чтения элементы этого объекта.

Это свойство только для чтения является ID отверстия текущего отверстия в этом документе.

Тип текущего отверстия шаблона, заданного как 'Inline' или 'Block'.

  • Встроенное отверстие для элементов документа, которые может содержать элемент абзаца: Textизображение, LinkTarget, ExternalLink, InternalLink, CharEntity, AutoNumber.

  • Отверстие блока может содержать ParagraphТаблица, OrderedList, UnorderedList, DocumentPart, или Group.

Это свойство применяется к Word и документам в формате PDF. Для документов Word значением является DOCXPageLayout объект, который задает текущий макет страницы. Для документов в формате PDF значением является PDFPageLayout возразите, задает ли документ в настоящее время макет страницы. Для документов HTML значение всегда [].

ID для этого элемента документа, указанного как вектор символов. DOM генерирует уникальный идентификатор сеанса, когда он создает элемент документа. Можно задать собственный ID.

Это списки свойств только для чтения открытое состояние этого элемента документа.

Это списки свойств только для чтения родительский элемент этого элемента документа.

Пометьте для элемента документа, указанного как вектор символов.

DOM генерирует уникальный для сеанса тег, когда он создает элемент документа. Структурируйте тег как class:id, где class класс элемента и id значение Id свойство. Можно задать тег, чтобы заменить сгенерированный тег. Определение вашего собственного тега может облегчить идентифицировать, где проблема произошла во время генерации документов.

Имя шаблона этой части, если шаблон хранится в библиотеке шаблонов части документа шаблона, заданного TemplatePath этой части свойство. Если это свойство [], шаблон, заданный TemplatePath свойство используется в качестве шаблона этой части.

Путь шаблона этой части или шаблона, библиотека шаблонов которого содержит шаблон этой части, заданный как вектор символов.

Выведите тип, заданный как одно из этих значений.

  • 'HTML' – Отчет HTML, группированный как заархивированный файл, содержащий файл HTML, изображения, таблицу стилей и файлы JavaScript отчета.

  • 'HTML-FILE' – Отчет HTML как один файл HTML, содержащий текст, таблицу стилей, JavaScript и base64-закодированные изображения отчета

  • 'PDF' pdfFile

  • 'DOCX' – Документ Microsoft Word

Если вы задаете шаблон с помощью TemplatePath свойство, значение для Type должен совпадать с типом шаблона.

Методы

Используйте DocumentPart методы как вы используют соответствующий Document методы.

Метод

Цель

addHTML

Используйте DocumentPart.addHTML похожим способом к тому, как вы используете Document.addHTML.

Добавьте текст HTML к документу

addHTMLFile

Используйте DocumentPart.addHTMLFile похожим способом к тому, как вы используете Document.addHTMLFile.

Добавьте содержимое файла HTML к документу

append

Добавьте элемент документа к части документа.

close

Закройте эту часть документа. Вы не можете закрыть часть документа, если она не была открыта или была ранее закрыта.

mlreportgen.dom.Document.createTemplate

Создайте шаблон части документа.

fill

Заполните отверстие документа.

mlreportgen.dom.Document.getCoreProperties

Получите базовые свойства части документа.

mlreportgen.dom.Document.getOPCMainPart

Получите полный путь основной части выходного документа.

moveToNextHole

Переместитесь, чтобы затем обработать отверстие по шаблону.

open

Откройте эту часть документа. Вы не можете открыть часть документа, если она была ранее открыта или закрыта. Вы также не можете открыть часть документа, если ее источник библиотеки закрывается.

mlreportgen.dom.Document.setCoreProperties

Установите базовые свойства части документа.

Примеры

свернуть все

Этот пример создает функциональный createMagicParts это задает часть документа на основе пустого шаблона части документа. Новая часть документа имеет заголовок, текст которого зависит от входа. Каждая сгенерированная часть документа содержит таблицу магического квадрата, внешний вид которой также основан на входе. Пример создает содержание функционального magicparts это добавляет часть документа к отчету итеративно на основе входа.

Создайте функцию.

function magic_square_report(square_sizes, report_type)
%MAGIC_SQUARE_REPORT Report on magic squares
%    magic_square_report(square_sizes, report_type) 
%    creates a report of the specified output type 
%    (docx, pdf, or html) on the specified magic
%    squares. For example, to create a PDF report on 
%    squares of size 5, 10, and 15, enter the following 
%    line at the MATLAB command line:
%
%      magic_square_report([5,10,15],'pdf');

import mlreportgen.dom.*;
rpt = Document('MagicSquareReport',report_type);
open(rpt);
for i = 1:length(square_sizes)
    sz = square_sizes(i);
    section = createSquareSection(rpt,sz);
    append(rpt,section);
end
close(rpt);
rptview(rpt.OutputPath);
 
function section = createSquareSection(rpt,square_size)
import mlreportgen.dom.*;
% Create document part to hold section
section = DocumentPart(rpt.Type);
% Create magic square heading
h1 = Heading1(sprintf('magic(%i)',square_size));
% Put each square on a separate page.
h1.Style = {PageBreakBefore(true)};
append(section,h1);
% Create table to hold square
table = append(section, Table(magic(square_size)));
% Format table
table.Border = 'solid';
table.ColSep = 'solid';
table.RowSep = 'solid';

Вызовите функцию, чтобы сгенерировать отчет. Измените входные параметры, чтобы изменить содержимое или выходной формат. Этот пример создает документ Word, который содержит три квадрата.

 magic_square_report([5,8,12],'docx');

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

Темы

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