Exponenta Banner
exponenta event banner

класс mlreportgen.report.BaseTable

Пакет: mlreportgen.report

Создание табличного репортера

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

Описание

Создайте репортер для таблицы с заголовком.

Строительство

table = BaseTable() создает пустой табличный репортер. Его свойства используются для указания содержимого таблицы, автоматически нумерованного заголовка таблицы, а также стиля и ширины таблицы.

table = BaseTable(content) создает табличный репортер, который форматирует content в виде таблицы и добавляет ее в отчет.

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

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

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

См. раздел mlreportgen.dom.Table, FormalTable, или MATLABTable свойства.

Свойства

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

Заголовок таблицы, указанный как одно из следующих значений:

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

  • Объект DOM

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

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

  • Репортер дыры, возвращенный getTitleReporter метод

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

  • Таблица в пронумерованной главе имеет префикс текста заголовка формы 'Таблица N.M. 'N - номер главы, а M - номер таблицы в главе. Например, префиксом для третьей таблицы во второй главе отчета является таблица 2.3.

  • Таблица в ненумерованной главе имеет префикс текста заголовка формы «Таблица N» N равно 1 для первой таблицы в отчете, 2 для второй таблицы и так далее.

Во многих неанглийских языковых стандартах префикс названия переводится на язык и формат языкового стандарта. См. свойство Locale для mlreportgen.report.Report список переведенных языковых стандартов.

Содержимое таблицы, указанное как одно из следующих значений:

  • DOM Table объект

  • DOM FormalTable объект

  • Объект таблицы DOM MATLAB ®

  • Двумерный массив или массив ячеек объектов DOM или встроенных объектов MATLAB

  • Репортер дыр, возвращенный getContentReporter метод

Используйте Section конструктор или add метод для установки этого свойства. Вы не можете установить его напрямую.

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

Пустое TableStyleName значение свойства определяет стиль таблицы по умолчанию, определенный для шаблона репортера. Стиль по умолчанию для таблицы - сетка.

Ширина этой таблицы, заданная как строка или символьный массив. TableWidth format -, где Units - аббревиатура для единиц ширины, а value - количество единиц. В таблице приведены допустимые сокращения единиц измерения.

Сокращение единиц измеренияЕдиницы
пкспиксели
cmсантиметры
вдюймы
mmмиллиметры
PCцицеро
ptпункты
%процент

Пример: 5in

Максимальное количество столбцов, отображаемых на срез таблицы, указанное как Inf или как положительное целое число. Если это свойство имеет значение Infвсе исходные столбцы таблицы включаются в одну таблицу. A MaxCols значение, большее или равное количеству столбцов таблицы, также создает одну таблицу со всеми столбцами. Большие наборы данных таблицы могут привести к созданию неразборчивых таблиц. Задайте для этого свойства количество столбцов из исходной таблицы, которые разборчиво помещаются на странице. Чтобы определить оптимальное значение, выполните итерацию, задав значение MaxCol значение и просмотр отчета.

Число начальных столбцов, повторяющихся на фрагмент, указанное как 0 или положительное целое число. Ненулевое число n повторяет первые n столбцов исходной таблицы в каждом фрагменте. MaxCols значение свойства включает в себя RepeatCols значение свойства. Например, если MaxCols равно 6 и RepeatCols равно 2, каждый фрагмент таблицы имеет в общей сложности шесть столбцов с первыми двумя столбцами, повторенными из исходной таблицы.

Имя пользовательского стиля, применяемого к заголовкам фрагментов таблицы, создаваемых этим репортером. Указанный стиль должен быть определен в отчете, к которому добавлен этот репортер. Если это свойство пустое ('', "", или []), заголовки фрагментов используют стиль по умолчанию, определенный в шаблоне репортера.

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

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

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

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

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

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

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

Методы

createTemplate Создать шаблон таблицы
customizeReporterСоздание класса отчетов настраиваемых базовых таблиц
getClassFolder Расположение файла определения класса базовых таблиц
getContentReporter Получение отчета о содержимом базовой таблицы
getTitleReporter Получить репортер заголовка базовой таблицы

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

копия Создание копии объекта reporter и создание глубоких копий определенных значений свойств
getImpl Получить реализацию репортера

Примеры

Добавление таблиц в отчет

Добавьте две таблицы в отчет. Первая таблица - магический квадрат 5 ранга. Вторая таблица содержит два изображения.

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

rpt = Report('tables');
chapter = Chapter();
chapter.Title = 'Table example';
add(rpt,chapter);

table = BaseTable(magic(5));
table.Title = 'Rank 5 Magic Square';
add(rpt,table);

add(rpt,Paragraph());
imgSize = {Height('2in'),Width('2in')};
img1 = Image(which('b747.jpg'));
img1.Style = imgSize;
img2 = Image(which('peppers.png'));
img2.Style = imgSize;
table = BaseTable({'Boeing 747' 'Peppers'; img1, img2});
table.Title = 'Picture Gallery';
add(rpt,table);

delete(gcf);
rptview(rpt);

См. также

| | | |

Темы

Представлен в R2017b

Документация по генератору отчетов MATLAB

Поддержка