append

Класс: mlreportgen.dom.Document
Пакет: mlreportgen.dom

Добавьте объект DOM или MATLAB к документу

Описание

domObjOut = append(docObj,textContent) добавляет текст или цифры к документу и возвращает текстовый объект. В Microsoft® Word и PDF выхода, текст переносится в абзац, поскольку Word и PDF не разрешают добавление неотвернутого текста в тело документа. В HTML- выход текст не переносится в абзац.

domObjOut = append(docObj,listContent) добавляет неупорядоченный список и возвращает неупорядоченный объект списка.

пример

domObjOut = append(docObj,tableContent) добавляет таблицу и возвращает объект таблицы.

domObjOut = append(docObj,paraObjpageLayoutObj) добавляет абзац, запускает новый раздел макета страницы, свойства которого заданы pageLayoutObject, и возвращает объект абзаца.

пример

domObjOut = append(___,styleName) добавляет заданное содержимое, используя заданный стиль.

пример

domObjOut = append(docObj,domObj) добавляет объект DOM к документу и возвращает этот объект.

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

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

Документ, к которому нужно добавить содержимое, заданный как mlreportgen.dom.Document объект.

Текст для добавления к документу, заданный как строка или вектор символов. Текстовый объект переносится в объект абзаца, и абзац добавляется к документу. Текст помещается в абзац, чтобы соответствовать Microsoft Word, что не позволяет добавлять текст в тело документа. Для HTML перенос текста может привести к неожиданному поведению.

Объект списка для добавления к документу, заданный как упорядоченный список, неупорядоченный список или массив. Если вход является 1D горизонтальным массивом двойных значений или строк или 1D категориальным массивом, создается объект неупорядоченного списка, и этот объект списка добавляется к документу.

Объект таблицы для добавления к документу, заданный как один из:

  • 2D массив двойных значений - Добавляет и возвращает объект таблица

  • 2D массив строк - Добавляет и возвращает объект таблица

  • 2D категориальный массив - Добавляет и возвращает объект таблица

  • Массив ячеек из строк для заголовка таблицы и числового, камер или категориального массива для тела таблицы - Добавляет и возвращает объект FormalTable

  • Таблица MATLAB - Добавляет и возвращает объект MATLABTable

Абзац для добавления к документу, заданный как объект абзаца. Также запускается новый раздел макета страницы со свойствами, заданными pageLayoutObj вход.

Макет страницы для применения к добавленному разделу макета страницы, заданному как объект PageLayout.

Стиль для применения к тексту, таблице или входу списка.

Объект DOM для добавления к документу, заданный как любой из следующих mlreportgen.dom объекты:

  • Контейнер

  • CustomElement

  • DOCXPageLayout

  • ExternalLInk

  • FormalTable

  • Группа

  • HorizontalRule

  • HTML

  • HTMLFile

  • Изображение

  • InternalLInk

  • LineBreak

  • LinkTarget

  • MATLABTable

  • NumPages

  • OrderedList

  • Страница

  • PageBreak

  • PageRef

  • Параграф

  • PDFPageLayout

  • RawText

  • StyleRef

  • Таблица

  • Текст

  • UnorderedList

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

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

Добавленный объект возвращен. Тип объекта зависит от второго входного типа.

Примеры

Добавление упорядоченного объекта списка

Создайте OrderedList объект и добавить его к отчету.

import mlreportgen.dom.*;
d = Document('mydoc','html');

ol = OrderedList({'first step' 'second step' 'last step'});
append(d,ol);

close(d);
rptview('mydoc','html');

Задайте стиль для добавляемого текста

Используйте Title Word стиль текста.

import mlreportgen.dom.*;
d = Document('mydoc','docx');
append(d,'This Is a Title','Title');
close(d);
rptview('mydoc','docx');

Добавление таблицы MATLAB

% Create a MATLAB table named patients from workspace variables. 
load patients;
BloodPreasure = [Systolic Diastolic];
patients = table(Gender,Age,Smoker,BloodPreasure);
patients.Properties.RowNames = LastName;

% Sort the table based on the Age variable. 
sorted = sortrows(patients,'Age');

% Create a report with the sorted patients table 
rpt = mlreportgen.dom.Document('MyFileName','pdf');
append(rpt,sorted);
close(rpt);

% Show the PDF report in the viewer
rptview(rpt.OutputPath);

Добавление массива ячеек в виде таблицы

import mlreportgen.dom.*;
d = Document('mydoc');
table = append(d,{'row 1 - col 1' 'row 1 - col 2';...
    'row 2 - col 1' 'row 2 - col 2'});
table.Style = {Border('double'),ColSep('solid'),RowSep('solid')};
close(d);
rptview('mydoc','html');
Введенный в R2014b
Для просмотра документации необходимо авторизоваться на сайте