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

Программный формат абзаца

Для форматирования можно использовать объекты формата 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;
}

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

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

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

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

Предположим, что определенным стилям присвоено имя BodyPara и MyTitle в шаблоне. Этот пример сначала задает имя стиля в Paragraph конструктор. Затем он задает стиль в Paragraph StyleName объекта формат. Этот пример предполагает, что оба стиля определены в 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);