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

Программно форматировать абзац

Для форматирования можно использовать объекты формата DOM API Paragraph объекты или свойства форматирования для указания часто используемых форматов абзацев. В этом примере используются:

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

p = Paragraph('Indent a half inch and space after 12 points.');
p.Style = {OuterMargin('0.5in','0in','0in','12pt')};
append(d,p);

p = Paragraph('Centered paragraph');
p.HAlign = 'center';
append(d,p);

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

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

Форматирование абзацев для Microsoft Word с использованием стилей шаблонов

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

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

Дополнительные сведения о работе со стилями Word см. в разделе Изменение стилей в шаблоне Microsoft Word.

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

Можно отформатировать абзац с помощью стиля в HTML или PDF-таблице стилей в шаблоне. Можно добавлять стили в шаблон или изменять существующие.

Определение стиля с помощью селектора на p элемент. В этом примере определяется BodyPara стиль абзаца.

p.BodyPara {
  font-family: "Times New Roman", Times, serif;
  font-style: normal;
  font-size: 11pt;
  color: black;
  margin-left: 0.5in;
}

В HTML-шаблонах можно использовать любые свойства и селекторы CSS. Для шаблонов PDF можно использовать подмножество свойств и селекторов CSS. См. раздел Изменение стилей в шаблонах PDF.

Дополнительные сведения об использовании стилей HTML с объектами DOM см. в разделе Изменение стилей в шаблонах HTML.

Применение стиля к объекту абзаца

Применение стиля шаблона к Paragraph объект либо в качестве второго аргумента в Paragraph конструктора объекта или путем установки StyleName свойства абзаца к стилю шаблона.

Предположим, что определены стили с именем BodyPara и MyTitle в шаблоне. В этом примере сначала указывается имя стиля в Paragraph конструктор. Затем он задает стиль в Paragraph объект StyleName свойство format. В этом примере предполагается, что оба стиля определены в MyTemplate.

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

% Specify style name using an argument when you create the Paragraph
p = Paragraph('Format this paragraph using a body style.','BodyPara');
append(rpt,p);

p = Paragraph('This paragraph is formatted using a title style.');

% Specify  style name using a property on the paragraph
p.StyleName = 'MyTitle';
append(rpt,p);

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

Переопределить форматы шаблонов

Программные форматы можно использовать для переопределения форматов абзацев, определенных в стиле абзацев на основе шаблона. Предположим, что определен стиль абзаца с именем BodyPara в шаблоне Word и установите KeepWithNext свойство для off. Можно переопределить стиль в программе отчетов, чтобы сохранить определенный абзац на той же странице со следующим абзацем:

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

p = Paragraph('Keep this body paragraph with next.','BodyPara');
p.Style = {'KeepWithNext'};
append(rpt,p);

p = Paragraph('Next paragraph.');
append(rpt, p);

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