Exponenta Banner

mlreportgen.dom.TableRow class

Пакет: mlreportgen.dom

Строка таблицы

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

Описание

Использование объектов mlreportgen.dom.TableRow Класс для создания строки таблицы.

The mlreportgen.dom.TableRow класс является handle класс.

Атрибуты класса

ConstructOnLoad
true
HandleCompatible
true

Для получения информации об атрибутах класса см. раздел «Атрибуты класса».

Создание

Описание

пример

tableRowObj = TableRow() создает пустую строку таблицы.

Свойства

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

Высота этой строки таблицы, заданная как вектор символов или строковый скаляр, который состоит из числа, за которым следует сокращение для единицы измерения. Для примера, '0.5in' задает половину дюйма. Допустимые сокращения:

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

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

  • in - дюймы

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

  • pc - picas

  • pt - точки

Если на Style свойство этой строки таблицы включает в себя mlreportgen.dom.RowHeight формат объекта, Height свойство устанавливается на высоту, заданную объектом формата.

Если вы задаете Height свойство для значения высоты, a RowHeight объект с заданной высотой создается и добавляется к Style свойство строки или используется для замены существующего RowHeight объект в Style свойство. The Type нового RowHeight объект 'exact'. Этот Type значение вызывает Microsoft® Word, чтобы сгенерировать строку заданной высоты и усечь содержимое, которое не подходит. Средства просмотра HTML и PDF создают строку, по крайней мере, заданную высоту и корректируют высоту строки так, чтобы она соответствовала содержимому.

Примечание

Если вы добавляете mlreportgen.dom.Height объект для Style свойство, оно преобразуется в mlreportgen.dom.RowHeight объект со Type установлено на 'atleast'. Этот Type значение приводит к тому, что средства просмотра HTML и PDF, а также Microsoft Word создают строку с заданной высотой, по крайней мере, и корректируют высоту строки так, чтобы она соответствовала содержимому.

Пример: '0.5in'

Записи таблицы в этой строке, заданные как массив mlreportgen.dom.TableEntry объекты. Используйте это свойство для доступа к записям таблицы в этой строке. Для примера этот код обращается к элементу 2 в строке 2:

t = Table({'e11', 'e12'; 'e21', 'e22'});
elem22 = t.row(2).Entries(2);

Вы также можете получить доступ к элементу 2 в строке 2 при помощи entry метод mlreportgen.dom.Table класс. Для примера:

t = Table({'e11', 'e12'; 'e21', 'e22'});
elem22 = entry(t,2,2);

Когда вы получаете доступ к TableEntry объект, который соответствует записи таблицы, можно отформатировать запись путем установки свойств объекта. См. раздел Формат записи таблицы.

Это свойство доступно только для чтения.

Количество записей таблицы в этой строке в виде целого числа. Это свойство доступно только для чтения.

Имя стиля для форматирования этой строки таблицы в виде вектора символов или строкового скаляра.

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

The StyleName свойство проигнорировано для выхода Word.

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

Вы можете задать высоту строки, добавив mlreportgen.dom.RowHeight или mlreportgen.dom.Height объект для Style свойство. Система координат mlreportgen.dom.Height объект преобразован в mlreportgen.dom.RowHeight объект с набором типов 'atleast'.

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

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

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

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

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

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

Методы

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

Примеры

свернуть все

Открыть Live Script

Чтобы добавить содержимое в пустую таблицу, добавьте записи таблицы в строки таблицы, а затем добавьте строки таблицы в таблицу. Этот пример создает эту таблицу два на два:

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

import mlreportgen.dom.*

d = Document();
t = Table(2);

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

tr1 = TableRow();
tr2 = TableRow();

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

append(tr1,TableEntry('e11'));
append(tr1,TableEntry('e12'));
append(tr2,TableEntry('e21'));
append(tr2,TableEntry('e22'));

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

append(t,tr1);
append(t,tr2);

Добавьте таблицу к документу. Закройте и просмотрите документ.

append(d,t);
close(d);
rptview(d);
Открыть Live Script

Используйте Entries свойство mlreportgen.dom.TableRow объект для доступа к mlreportgen.dom.TableEntry объект, который соответствует записи, которую вы хотите отформатировать. Формат записи путем установки свойств формата TableEntry объект или путем добавления объектов формата к Style свойство объекта. Этот пример изменяет цвет текста второй записи второй строки на красный.

import mlreportgen.dom.*
d = Document();
t = Table({'e11','e12';'e21','e22'});
t.row(2).Entries(2).Style = {Color('red')};
append(d,t);
close(d);
rptview(d);

В получившейся таблице текст, e22, во второй записи второй строки красным цветом.

Кроме того, вы можете получить доступ к записи таблицы при помощи entry метод mlreportgen.dom.Table объект, который содержит запись. В предыдущем примере замените: 

t.row(2).Entries(2).Style = {Color('red')};

с:

elem = entry(t,2,2);
elem.Style = {Color('red')};

См. также

| | | | |

Темы

Введенный в R2013b

MATLAB Report Generator

Поддержка