Документация

Создание стиля таблицы Word

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

Чтобы определить стиль таблицы в таблице стилей Word, выполните следующие действия.

Пример форматирования с использованием шаблона Word см. в разделе Создание таблицы с зеброй-полосатой структурой.

Создание стиля таблицы HTML или PDF

Таблицы HTML и PDF можно форматировать с помощью стиля CSS, определенного в шаблоне. Сведения о создании шаблона HTML или PDF см. в разделе Создание шаблона HTML или PDF.

Чтобы определить стиль таблицы в шаблоне HTML или PDF, используйте table селектор с именем класса. Например, этот код CSS задает стиль для таблиц с классом MyTable.

table.MyTable {
  border-style: solid;
  border-bottom-color: rgb(128, 128, 128);
  border-bottom-width: thin;
  border-collapse: collapse;
}

Можно использовать селектор потомков CSS (пробел) или селектор потомков (>) для указания формата потомков или потомков таблицы. Например, этот код CSS определяет формат записей таблицы (td элементы) таблицы, стиль которой MyTable.

table.MyTable td { 
      font-family: Arial, Helvetica, sans-serif; 
      font-size: 11pt; 
      text-align: center; 
   } 

См. разделы Изменение стилей в шаблонах HTML и Изменение стилей в шаблонах PDF.

Сведения о редактировании CSS см. в документации, например https://developer.mozilla.org/en-US/docs/Web/CSS/Reference.

Пример форматирования с использованием HTML-шаблона см. в разделе Создание таблицы с зеброй.

Применение стиля к таблице или элементу таблицы

После определения стиля в шаблоне его можно применить к объекту, представляющему таблицу или элемент таблицы в программе отчетов. Укажите стиль в качестве аргумента конструктору объекта или назначьте его StyleName свойства объекта. Стиль можно применить к заголовку, телу или разделу нижнего колонтитула mlreportgen.dom.FormalTable или mlreportgen.dom.MATLABTable путем назначения стиля StyleName имущества mlreportgen.dom.TableHeader, mlreportgen.dom.TableBody, или mlreportgen.dom.TableEntry объект.

Например, предположим, что определены стили BodyPara, TableTitle, и RuledTable в шаблоне для отчета. В этом примере указываются имена стилей в Paragraph конструктор, в StyleName свойство Paragraph объект и в Table конструктор.

import mlreportgen.dom.*;
rank = 5;
rpt = Document('MyReport','html','MyTemplate');

p = Paragraph('Here is a magic square or rank 5:','BodyPara');
append(rpt,p);

p = Paragraph(sprintf('Rank %d MagicSquare',rank));
p.StyleName = 'TableTitle';

append(rpt,Table(magic(rank),'RuledTable'));

close(rpt);
rptview(rpt.OutputPath);

Программные форматы можно использовать для переопределения стилей, определенных в стиле таблицы на основе шаблона. Например, предположим, что определен стиль таблицы с именем UnruledTable в шаблоне для создания таблиц без границ, разделителей столбцов или строк. Затем можно переопределить стиль в программе отчетов, чтобы нарисовать рамку вокруг таблицы.

import mlreportgen.dom.*;
rpt = Document('MyReport','html','MyTemplate');

table = Table(magic(5),'UnruledTable');
table.Border = 'single';
append(rpt,table);

close(rpt);
rptview(rpt.OutputPath);

Дополнительные сведения о программном форматировании см. в разделе Программное форматирование таблиц.

Форматирование записей таблицы с использованием таблиц стилей

Для HTML-отчетов и отчетов PDF для форматирования записей таблицы можно использовать стили, определенные в таблице стилей HTML-шаблонов. При определении стиля записи таблицы используйте td селектор элемента. Например:

td.TableEntryWithBorder {
  border:5px solid red;
}

Чтобы применить определенный шаблоном стиль к записи таблицы, задайте TableEntry объект StyleName для имени стиля или укажите имя стиля в качестве второго аргумента TableEntry конструктор. Например:

te = TableEntry('Hello World','TableEntryWithBorder');

Программное форматирование неформальной таблицы

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

import mlreportgen.dom.*
d = Document('test','html');

table = Table(magic(5));
table.Style = [table.Style {Border('inset','red','3px'), ...
               ColSep('single','black','1px'), ...
               RowSep('single','black','1px')}];

table.BackgroundColor = 'lightsteelblue';

append(d, table);

close(d);
rptview(d.OutputPath);

Программное форматирование формальной таблицы или таблицы MATLAB

Для форматирования можно использовать свойства и объекты формата mlreportgen.dom.FormalTable и mlreportgen.dom.MATLABTable объекты. Если указать формат таблицы и одного из ее разделов, значение, указанное для раздела, переопределяет значение таблицы в целом. Не все формальные форматы таблиц применяются к формальным разделам таблиц. Например, OuterLeftMargin свойство не применяется к формальным разделам таблицы. Невозможно создать отступы для верхнего, нижнего или нижнего колонтитула независимо от таблицы, в которой он содержится.

Форматирование записи таблицы

Чтобы получить доступ к записи таблицы для форматирования, можно использовать entry метод mlreportgen.dom.Table, mlreportgen.dom.TableHeader, mlreportgen.dom.TableBody, или mlreportgen.dom.TableFooterобъект.

entry метод возвращает mlreportgen.dom.TableEntry или mlreportgen.dom.TableHeaderEntry объект. Для форматирования записи можно использовать следующие TableEntry форматировать свойства или объекты.

Можно использовать другие объекты формата, которые применяются к объектам, содержащимся в записи таблицы. API-интерфейс DOM игнорирует объекты формата, которые не применяются к определенному объекту.

В этом примере создается таблица из выходных данных magic и делает максимальное количество таблицы красным.

import mlreportgen.dom.*;

d = Document('test','pdf');

m = magic(5);
[v,i] = max(m);
[v1,i1] = max(max(m));
t = Table(m);
t.Border = 'single';
t.ColSep = 'single';
t.RowSep = 'single';

t.TableEntriesInnerMargin = '2pt';
t.TableEntriesHAlign = 'right';

maxnum = entry(t,i(i1),i1);
maxnum.Children(1).Color = 'Red';

append(d,t);

close(d);
rptview(d);

Форматировать все записи таблицы

Чтобы задать один и тот же формат или набор форматов для всех записей таблицы DOM или раздела таблицы DOM, можно использовать следующие свойства:

В этом примере создается таблица из таблицы MATLAB. Пример:

import mlreportgen.dom.*
d = Document('outermargin','docx');

import mlreportgen.dom.*
d = Document('myMATLABTable','pdf');

Age = [38;43;38;40;49];
Height = [71;69;64;67;64];
Weight = [176;163;131;133;119];
mltable = table(Age,Weight,Height);

mltableObj = MATLABTable(mltable);
tbodyObj = mltableObj.Body;
tbodyObj.TableEntriesStyle = {Color('blue')};
tbODYObj.TableEntriesHAlign = 'center';

append(d,mltableObj);

close(d);
rptview(d);

Форматирование строки таблицы

Для доступа к строке таблицы для форматирования можно использовать row метод mlreportgen.dom.Table, mlreportgen.dom.TableHeader, mlreportgen.dom.TableBody, или mlreportgen.dom.TableFooter объект.

row метод возвращает mlreportgen.dom.TableRow объект. Для форматирования строки можно использовать следующие TableRow форматировать свойства или объекты.

Можно использовать другие объекты формата, которые применяются к объектам, содержащимся в строке. API-интерфейс DOM игнорирует объекты формата, которые не применяются к определенному объекту.

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

import mlreportgen.dom.*;

d = Document('test','pdf');

m = magic(5);
[v,i] = max(m);
[v1,i1] = max(max(m));
t = Table(m);
t.Border = 'single';
t.ColSep = 'single';
t.RowSep = 'single';

t.TableEntriesInnerMargin = '2pt';
t.TableEntriesHAlign = 'right';

r = row(t,1);
r.Style = [r.Style {Color('red')}];
append(d,t);
close(d);
rptview(d);

Форматирование столбцов таблицы

Чтобы указать формат группы смежных столбцов таблицы, используйте mlreportgen.dom.TableColSpecGroup объект. Чтобы переопределить форматы группы столбцов для некоторых столбцов, используйте mlreportgen.dom.TableColSpec объект.

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

import mlreportgen.dom.*
rpt = Document('test','pdf');

rank = 5;
t = Table(magic(rank));
t.Border = 'single';
t.ColSep = 'single';
t.RowSep = 'single';
t.TableEntriesInnerMargin = '2pt';
t.TableEntriesHAlign = 'right';

%Specify the formats for all columns
grps(1) = TableColSpecGroup;
grps(1).Span = rank;
grps(1).Style = {Color('green')};

%Specify the formats for the first column
specs(1) = TableColSpec;
specs(1).Span = 1;
specs(1).Style = {Bold(true),Color('red')};

grps(1).ColSpecs = specs;

t.ColSpecGroups = grps;
append(rpt,t);

close(rpt);
rptview(rpt.OutputPath);

Чтобы изменить размер столбцов в соответствии с самым широким содержимым записей таблицы в столбце, включите ResizeToFitContents объект в Style свойства таблицы.