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

Отформатируйте таблицу программно

Можно использовать объекты формата, чтобы отформатировать таблицы или использовать свойства формата Table, чтобы задать обычно используемые форматы таблицы. Этот пример использование:

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

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

table.Width = '50%';

append(d, table);

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

Используйте эти объекты формата и свойства формата, чтобы отформатировать таблицу.

Записи таблицы формата

Объект Table имеет свойства, которые позволяют вам задавать тот же формат или набор форматов для всех его записей.

Можно использовать объект формата mlreportgen.dom.TextOrientation, чтобы сделать текст в записи таблицы вертикальным или горизонтальным.

Сохраните таблицу и заголовок на той же странице

Используйте KeepLinesTogether и форматы абзаца KeepWithNext, чтобы держать вместе табличный заголовок и таблицу на той же странице. Этот пример создает табличный заголовок, создает табличное содержимое и делает табличную строку заголовка полужирной, использующей индексацией записи таблицы. Чтобы сохранить таблицу на той же странице, код задает KeepLinesTogether и KeepWithNext для всех строк кроме последней строки. Последняя строка имеет только набор KeepLinesTogether и не KeepWithNext. Это препятствует тому, чтобы таблица была обеспечена, чтобы остаться с абзацем, который следует.

import mlreportgen.dom.*
rpt = Document('test','docx');
 
p = Paragraph('Table 1');
p.Style = {Bold,KeepLinesTogether,KeepWithNext};
append(rpt, p);
 
ca = {Paragraph('Col 1'),Paragraph('Col 2'); ...
      Paragraph('data 11'),Paragraph('Data 12'); ...
      Paragraph('data 21'),Paragraph('Data 22')};
 
ca{1,1}.Children(1).Bold = true;
ca{1,2}.Children(1).Bold = true;
 
for r = 1:2
    for c = 1:2
        ca{r, c}.Style = {KeepLinesTogether,KeepWithNext};
    end
end
 
for c = 1:2
    ca{3, c}.Style = {KeepLinesTogether};
end
 
 append(rpt, ca);
 
close(rpt);
rptview(rpt.OutputPath);

Отформатируйте таблицу Используя таблицы стилей Microsoft Word

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

Чтобы задать стиль таблицы, одним словом, обрабатывают по шаблону, запускаются при помощи этих шагов.

Для получения дополнительной информации об использовании стилей Word с Объектами DOM смотрите, Изменяют Стили в Шаблоне Microsoft Word.

Отформатируйте HTML или таблицу PDF Используя таблицу стилей

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

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

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

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

Примените стиль к таблице

Если вы задали стиль таблицы в шаблоне, можно применить его к объекту Table в программе отчета или в качестве второго аргумента в конструкторе Object Table или путем установки его на свойство StyleName объекта Table. Например, предположите, что вы задали стили под названием 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);

Отформатируйте формальную таблицу программно

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

Примените стили таблицы к формальной таблице и ее разделам

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

Можно применить стиль таблицы к формальной таблице и к каждому из ее разделов. Если вы применяете стиль таблицы к самой таблице и к одному из ее разделов (например, заголовок), стиль раздела заменяет стиль таблицы.

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

Конструктор mlreportgen.dom.TableRow не берет аргументов и возвращает объект TableRow. Можно затем создать и добавить объекты TableEntry к объекту завершить конструкцию строки. Если вы создаете строку, можно добавить строку в таблицу, с помощью функции append. Этот пример составляет таблицу 2D столбца с двумя строками.

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

table = Table(2); 
 
row = TableRow();
append(row,TableEntry('Col1'));
append(row,TableEntry('Col2'));
append(table,row);
 
row = TableRow();
append(row,TableEntry('data11'));
append(row,TableEntry('data12'));
append(table,row);
 
append(rpt,table);

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

Отформатируйте строку таблицы

Используйте эти объекты формата и свойства формата, чтобы отформатировать строку таблицы.

Создайте запись таблицы

Используйте конструктора TableEntry, чтобы создать запись таблицы. Можно опционально использовать конструктора, чтобы задать эти виды содержимого записи:

Записи таблицы формата программно

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

Можно задать форматирование для всех записей таблицы в таблице, использовать свойство TableEntriesStyle объекта Table или FormalTable. Например, можно установить форматирование границы.

import mlreportgen.dom.*
t = Table(magic(5));
t.TableEntriesStyle = {Border('solid','black','1px')};

Свойства, которые вы устанавливаете для объекта TableEntry, более приоритетны по сравнению с объектами формата TableEntriesStyle.

Записи таблицы формата Используя таблицы стилей

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

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

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

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