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 (truecolor) в форме #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'

Нет линии

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

HTML и PDF

'inset'

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

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

'none'

Нет линии

The 'hidden' тип границы также не создает линию. Однако конфликтующие границы обрабатываются по-разному 'hidden' типы, чем для 'none' типы. The '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 (truecolor) как #RRGGBB. Для примера, #0000ff - оттенок синего.

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

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

  • cm - сантиметров

  • in - дюймы

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

  • pc - picas

  • pt - точки

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

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

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

Цвет линий, разделяющих столбцы, задается как:

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

  • Шестнадцатеричное значение RGB (truecolor) как #RRGGBB. Для примера, #0000ff - оттенок синего.

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

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

  • cm - сантиметров

  • in - дюймы

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

  • pc - picas

  • pt - точки

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

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

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

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

  • 'ltr' - Поток слева направо (столбец 1 расположен слева в таблице).

  • 'rtl' - Поток справа налево (столбец 1 расположен справа в таблице).

Горизонтальное выравнивание этой таблицы, заданное как одно из следующих значений:

  • 'center'

  • 'left'

  • 'right'

Примечание

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

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

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

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

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

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

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

  • cm - сантиметров

  • in - дюймы

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

  • pc - picas

  • pt - точки

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

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

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

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

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

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

  • Шестнадцатеричное значение RGB (truecolor) как #RRGGBB. Для примера, #0000ff - оттенок синего.

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

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

  • cm - сантиметров

  • in - дюймы

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

  • pc - picas

  • pt - точки

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

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

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

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

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

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

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

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

  • cm - сантиметров

  • in - дюймы

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

  • pc - picas

  • pt - точки

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

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

Процент (для примера, '100%') ширины страницы (минус поля для отчетов Word) или ряда единиц измерения, имеющих формат valueUnits. Units - сокращение для модулей. Это действительные сокращения:

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

  • cm - сантиметров

  • in - дюймы

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

  • pc - picas

  • pt - точки

Методы

Метод

Цель

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);

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