exponenta event banner

mlreportgen.dom.MATLABTable класс

Пакет: 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'

Без строки

'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 (truecolor) как #RRGGBB. Например, #0000ff - оттенок синего.

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

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

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

  • in - дюймы

  • mm - миллиметров

  • pc - пикас

  • 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 - пикас

  • 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 - пикас

  • pt - точки

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

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

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

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

Можно указать:

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

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

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

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

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

  • in - дюймы

  • mm - миллиметров

  • pc - пикас

  • pt - точки

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

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

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

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

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

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

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

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

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

  • in - дюймы

  • mm - миллиметров

  • pc - пикас

  • pt - точки

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

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

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

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

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

  • in - дюймы

  • mm - миллиметров

  • pc - пикас

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

Вот таблица в созданном отчете: