Exponenta Banner
exponenta event banner

класс mlreportgen.dom.TaureRow

Пакет: mlreportgen.dom

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

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

Описание

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

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

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

ConstructOnLoad
true
HandleCompatible
true

Сведения об атрибутах класса см. в разделе Атрибуты класса.

Создание

Описание

пример

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

Свойства

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

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

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

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

  • in - дюймы

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

  • pc - пикас

  • pt - точки

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

Если установить Height свойство для значения высоты, a RowHeight объект с указанной высотой создается и добавляется к Style свойства строки или используется для замены существующего RowHeight объект в Style собственность. 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 переопределение свойств форматами, определенными в стиле.

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 создает уникальный идентификатор сеанса. Можно указать собственный идентификатор.

Методы

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

Примеры

свернуть все

Открыть сценарий в реальном времени

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

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

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);
Открыть сценарий в реальном времени

Используйте 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

Поддержка