mlreportgen.dom.MATLABTable class

Пакет: mlreportgen.dom

Описание

Преобразовывает таблицу MATLAB® в таблицу DOM.

Конструкция

MLTableObj = MATLABTable(table) создает объект таблицы на основе заданной таблицы MATLAB.

MLTableObj = MATLABTable(table,stylename) создает объект таблицы и применяет заданный стиль таблицы. Задайте стиль в шаблоне, используемом, чтобы сгенерировать отчет, содержащий эту таблицу.

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

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

Таблица MATLAB.

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

Разработайте, чтобы примениться к таблице в виде вектора символов.

Свойства

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

Цвет фона в виде вектора символов или строкового скаляра, который состоит из названия цвета CSS (см. https://www.crockford.com/wrrrld/color.html), или шестнадцатеричный RGB (истинный цвет) значение в форме #RRGGBB.

Установка BackgroundColor свойство добавляет соответствующий mlreportgen.dom.BackgroundColor объект формата к Style свойство. Установка BackgroundColor свойство к пустому значению удаляет объект.

Пример: 'blue'

Пример: '#0000ff'

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

Тип границы, чтобы чертить в виде одного из значений в таблице.

Ограничьте значениеОписаниеПоддерживаемые Выходные типы

'dashed'

Пунктирная линия

Все выходные типы

'dashdotstroked'

Линия с переменными диагональными тире и точкой

Word

'dashsmallgap'

Пунктирная линия с маленьким разрывом между тире

Word

'dotted'

Пунктирная линия

Все выходные типы

'dotdash'

Линия с чередованием точек и тире

Word

'dotdotdash'

Линия с чередованием двойных точек и тире

Word

'double'

Двойная линия

Все выходные типы

'doublewave'

Удвойте волнистую линию

Word

'groove'

3-D эффект формировал канавки линия

HTML и PDF

'hidden'

Никакая линия

'none' тип границы также не продолжает линии. Однако конфликтные границы обработаны по-другому для 'hidden' типы, чем для 'none' типы. 'hidden' тип границы более приоритетен по сравнению с конфликтным типом границы. Конфликтный тип границы более приоритетен по сравнению с 'none' ввод.

HTML и PDF

'inset'

3-D линия эффекта

Все выходные типы

'none'

Никакая линия

'hidden' тип границы также не продолжает линии. Однако конфликтные границы обработаны по-другому для 'hidden' типы, чем для 'none' типы. 'hidden' тип границы более приоритетен по сравнению с конфликтным типом границы. Конфликтный тип границы более приоритетен по сравнению с 'none' ввод.

Все выходные типы

'outset'

3-D линия эффекта

Все выходные типы

'ridge'

3-D эффект остроконечная линия

HTML и PDF

'single'

Одна строка

Word

'solid'

Одна строка

HTML и PDF

'thick'

Толстая линия

Word

'thickthinlargegap'

Пунктирная линия с чередованием толстых и тонких тире с большим разрывом

Word

'thickthinmediumgap'

Пунктирная линия с чередованием толстых и тонких тире со средним разрывом

Word

'thickthinsmallgap'

Пунктирная линия с чередованием толстых и тонких тире с маленьким разрывом

Word

'thinthicklargegap'

Пунктирная линия с переменными тонкими и толстыми тире со средним разрывом

Word

'thinthickmediumgap'

Пунктирная линия с переменными тонкими и толстыми тире, со средним разрывом

Word

'thinthicksmallgap'

Пунктирная линия с переменными тонкими и толстыми тире с маленьким разрывом

Word

'thinthickthinlargegap'

Пунктирная линия с переменными тонкими и толстыми тире с большим разрывом

Word

'thinthickthinmediumgap'

Пунктирная линия с переменными тонкими и толстыми тире со средним разрывом

Word

'thinthickthinsmallgap'

Пунктирная линия с переменными тонкими и толстыми тире с маленьким разрывом

Word

'threedemboss'

Рельефная линия эффекта

Word

'threedengrave'

Выгравированная линия эффекта

Word

'triple'

Тройная линия

Word

'wave'

Волнистая линия

Word

Значение 'on' границы коллапсов соседних элементов в одну границу. Значение 'off' сохраняет границы соседних элементов.

Цвет рамки в виде также:

  • Имя цвета. Имя должно быть названием цвета CSS. См. https://www.crockford.com/wrrrld/color.html.

  • Шестнадцатеричный RGB (истинный цвет) значение как #RRGGBB. Например, #0000ff оттенок синего цвета.

Ширина границы таблицы, заданная в форме valueUnits, где Units сокращение от модулей. Допустимые сокращения:

  • px — пиксели (значение по умолчанию)

  • cm 'centimeters'

  • in 'inches'

  • mm — миллиметры

  • pc — цицеро

  • pt 'points'

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

Стиль линии, разделяющей столбцы табличного или табличного раздела (заголовок, тело, нижний колонтитул), как задано mlreportgen.dom.ColSep объект.

См. описание Border свойство для описания возможных значений.

Цвет столбцов разделения линии в виде также:

  • Имя цвета. Имя должно быть названием цвета CSS. См. https://www.crockford.com/wrrrld/color.html.

  • Шестнадцатеричный RGB (истинный цвет) значение как #RRGGBB. Например, #0000ff оттенок синего цвета.

Ширина столбцов таблицы разделения линии, в форме valueUnits. Используйте одно из этих сокращений от Units:

  • px — пиксели (значение по умолчанию)

  • cm 'centimeters'

  • in 'inches'

  • mm — миллиметры

  • pc — цицеро

  • pt 'points'

Например, для разделителя столбцов 3 точек, устанавливает ColSepWidth свойство к '3pt'.

Массив mlreportgen.dom.TableColSpecGroup объекты, который задает ширину, выравнивание и другие свойства группы столбцов. Первый объект применяется к первой группе столбцов, второму объекту второй группе, и так далее. Задайте количество столбцов, принадлежащих каждой группе, использующей Span свойство TableColSpecGroup объект. Например, если первый объект имеет промежуток 2, он применяется к первым двум столбцам. Если у второй группы есть промежуток 3, она применяется к следующим трем столбцам и так далее.

Пользовательские атрибуты должны поддерживаться выходным типом документа, к которому добавлен этот элемент документа.

Направление потока столбца в виде:

  • 'ltr' — Теките слева направо (столбец 1 находится налево в таблице).

  • 'rtl' — Теките справа налево (столбец 1 находится направо в таблице).

Выравнивание по горизонтали этой таблицы в виде одного из этих значений:

  • 'center'

  • 'left'

  • 'right'

Примечание

Чтобы предотвратить переполнение больших таблиц в PDF выход, установите Width свойство.

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

Горизонтальное правило для заголовка в виде mlreportgen.dom.HorizontalRule объект.

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

Количество столбцов в виде целого числа.

Оставленное добавление отступа в форме valueUnitsМодули сокращение от модулей. Допустимые сокращения:

  • px — пиксели (значение по умолчанию)

  • cm 'centimeters'

  • in 'inches'

  • mm — миллиметры

  • pc — цицеро

  • pt 'points'

Родительский элемент этого элемента документа в виде Объекта DOM. Это свойство доступно только для чтения.

Свойство включить правило о первом столбце, который содержит имена строки в виде логического. Объект таблицы MATLAB должен задать имена строки.

Стиль линии, разделяющей строки табличного или табличного раздела (заголовок, тело или нижний колонтитул).

См. описание Border свойство для описания возможных значений.

Можно задать:

  • Имя цвета. Имя должно быть названием цвета CSS. См. https://www.crockford.com/wrrrld/color.html.

  • Шестнадцатеричный RGB (истинный цвет) значение как #RRGGBB. Например, #0000ff оттенок синего цвета.

Ширина диафрагмы строки, заданной в форме valueUnits где Units сокращение от модулей. Допустимые сокращения:

  • px — пиксели (значение по умолчанию)

  • cm 'centimeters'

  • in 'inches'

  • mm — миллиметры

  • pc — цицеро

  • pt 'points'

Массив объектов формата (таких как Bold объекты), которые задают формат для этой таблицы.

Это свойство заменяет соответствующие форматы, заданные стилем таблицы стилей, заданным StyleName свойство.

Имя стиля задало в таблице стилей части документа или документа, к которой добавлена эта таблица.

Стиль, который задает внешний вид этой таблицы в выходном документе для форматов, не заданных Style свойство.

Можно установить StyleName свойство любого формального табличного раздела. Установка StyleName заменяет стиль, заданный самой формальной таблицей. Однако, если вы делаете это для документа Word, необходимо явным образом задать ширину каждого столбца в разделе, чтобы гарантировать, что все разделы имеют ту же ширину. Word, в отличие от HTML и PDF, не имеет никакой встроенной поддержки формальных таблиц. Чтобы обработать это, интерфейс DOM представляет формальную таблицу как три таблицы, один для каждого раздела, встроенного в таблицу 3 на 1.

Массив ячеек объектов формата, которые задают формат для записей таблицы.

Внутреннее поле является полем между содержимым ячейки таблицы и границами ячейки в форме valueUnits где Units сокращение от модулей. Допустимые сокращения:

  • px — пиксели (значение по умолчанию)

  • cm 'centimeters'

  • in 'inches'

  • mm — миллиметры

  • pc — цицеро

  • pt 'points'

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

DOM генерирует уникальный для сеанса тег как часть создания этого объекта. Сгенерированный тег имеет форму CLASS:ID, где КЛАСС является классом объекта, и ID является значением Id свойство объекта. Определение вашего собственного значения тега может помочь вам идентифицировать, где проблема произошла во время генерации документов.

Процент (например, '100%') из страницы width (минус поля для отчетов Word) или много единиц измерения, имея формат valueUnitsМодули сокращение от модулей. Это допустимые сокращения:

  • px — пиксели (значение по умолчанию)

  • cm 'centimeters'

  • in 'inches'

  • mm — миллиметры

  • pc — цицеро

  • pt 'points'

Методы

Метод

Цель

append

Используйте FormalTable.append похожий на то, как вы используете TableRow.append.

Добавьте строку записей таблицы к таблице.

clone

Используйте FormalTable.clone тем же путем вы используете Paragraph.clone.

Скопируйте таблицу.

Примеры

свернуть все

Этот пример составляет таблицу DOM из таблицы MATLAB, которая имеет имена строки. Пример генерирует два отчета, которые включают таблицу DOM. В первом отчете столбец имен строки таблицы не имеет метки. Во втором отчете столбец имен строки имеет метку.

Составьте таблицу MATLAB, которая показывает возраст, вес и высоту пациентов. Используйте RowNames опция, чтобы идентифицировать каждую строку фамилией пациента.

LastName = {'Sanchez';'Johnson';'Lee';'Diaz';'Brown'};
Age = [38;43;38;40;49];
Weight = [176;163;131;133;119];
Height = [71;69;64;67;64];
mltable = table(Age,Weight,Height,'RowNames',LastName)
mltable=5×3 table
               Age    Weight    Height
               ___    ______    ______

    Sanchez    38      176        71  
    Johnson    43      163        69  
    Lee        38      131        64  
    Diaz       40      133        67  
    Brown      49      119        64  

Таблица MATLAB имеет пять строк и три столбца. Имена строки не являются частью таблицы. Они хранятся в свойстве таблицы.

Создайте mlreportgen.dom.MATLABTable объект от MATLAB таблица.

import mlreportgen.dom.*
mltableObj = MATLABTable(mltable);

Создайте документ и добавьте MATLABTable возразите против документа. Закройте и просмотрите документ.

d = Document('MyMATLABTable1','docx');
append(d,mltableObj);
close(d);
rptview(d);

Вот таблица в сгенерированном отчете:

Таблица DOM является формальной таблицей, которая имеет заголовок и тело. Табличное тело имеет пять строк и четыре столбца. Первый столбец состоит из имен строки таблицы MATLAB.

Сгенерируйте отчет снова, на этот раз с меткой для столбца имен строки. Чтобы задать метку, замените пустой текст в первой записи табличной строки заголовка с текстом метки. Чтобы чертить линию под маркой, установите RowNamesRule свойство MATLABTable возразите против true.

LastName = {'Sanchez';'Johnson';'Lee';'Diaz';'Brown'};
Age = [38;43;38;40;49];
Weight = [176;163;131;133;119];
Height = [71;69;64;67;64];
mltable = table(Age,Weight,Height,'RowNames',LastName);
import mlreportgen.dom.*
mltableObj = MATLABTable(mltable);
th = mltableObj.Header;
thentry11 = entry(th,1,1);
thentry11.Children(1).Children(1).Content = 'Names';
mltableObj.RowNamesRule = true;
d = Document('MyMATLABTable2','docx');
append(d,mltableObj);
close(d);
rptview(d);

Вот таблица в сгенерированном отчете: