Можно создать текст путем добавления вектора символов к документу, абзацу, записи таблицы, или перечислить элемент. Функция append DOM преобразовывает вектор символов в объект Text, добавляет его и возвращает объект Text. Используйте объект Text отформатировать текст. Можно также создать текстовый объект непосредственно и добавить его к документу. Этот пример:
Создает объект Text t1 путем добавления 'Hello' документ
Использует конструктора Text, чтобы создать объект Text и добавить текст 'World' к документу
import mlreportgen.dom.* d = Document('mydoc','html'); t1 = append(d,'Hello'); append(d,Text('World')); close(d); rptview(d.OutputPath);
Можно задать специальные символы, такие как символ британского фунта, чтобы включать в отчет путем создания объекта mlreportgen.dom.CharEntity. Задайте имя символьной сущности, перечисленной по https://en.wikipedia.org/wiki/List_of_XML_and_HTML_character_entity_references. Например:
import mlreportgen.dom.*; d = Document('test','html'); p = Paragraph(CharEntity('pound')); append(d,p); append(p,'3'); close(d); rptview(d.OutputPath);
Чтобы добавить разметку HTML к документу HTML или Microsoft® разметка XML Word к документу Word, используйте объект mlreportgen.dom.RawText. Этот метод полезен для создания HTML или элементов Word, которые API DOM не поддерживает непосредственно. Этот пример показывает, как создать объект RawText добавить разметку HTML.
import mlreportgen.dom.*;
d = Document('test','html');
append(d,RawText('<em>Emphasized Text</em>'));
close(d);
rptview('test','html');
Можно отформатировать текст программно, с помощью или объектов формата DOM или свойств формата объекта Text. Можно также использовать стили шаблонов. Для получения информации об этих методах форматирования и наследовании формата, см. Отчет Форматировать Подходы.
Можно использовать объекты формата, чтобы отформатировать объекты Text или свойства формата, чтобы задать обычно используемые текстовые форматы. Этот пример использование:
Объект формата FontFamily, чтобы задать первичный и резервный шрифт
Свойство формата Bold, чтобы задать текстовый вес
import mlreportgen.dom.*; d = Document('test','html'); t = append(d,'Bold Arial text'); fontFamily = FontFamily('Arial'); fontFamily.BackupFamilyNames = {'Helvetica'}; t.Style = {fontFamily}; t.Bold = true; close(d); rptview(d.OutputPath);
Используйте эти объекты формата и свойства формата, чтобы отформатировать текст.
| Форматирование | Объект формата | Свойство формата |
|---|---|---|
Шрифт |
|
|
Резервный шрифт (только HTML) |
| нет данных |
Комплексный шрифт скрипта (например, арабский язык) |
| нет данных |
Восточноазиатский шрифт |
| нет данных |
'FontSize' |
|
|
ForegroundColor |
|
|
BackgroundColor |
|
|
Полужирный |
|
|
Курсив |
|
|
Индекс или верхний индекс |
| нет данных |
Перечеркнуть |
|
|
Подчеркните тип (один, дважды, и т.д.) |
|
|
Цвет подчеркивания |
| нет данных |
Сохраните пробел |
|
|
Отображение, как задано |
| нет данных |
Можно отформатировать абзац с помощью стиля, заданного в шаблоне Word, используемом, чтобы сгенерировать отчет.
Чтобы задать стиль текста, одним словом, обрабатывают по шаблону, запускаются при помощи этих шагов:
Откройте шаблон Word, используемый с отчетом.
Откройте панель Styles.
Нажмите кнопку Manage Styles
.
Нажмите New Style.
В диалоговом окне Create New Style from Formatting, набор Style type к Character или Linked (paragraph and character).
Для получения дополнительной информации о работе со стилями Word, смотрите, Изменяют Стили в Шаблоне Microsoft Word.
Можно отформатировать текст с помощью стиля, заданного в шаблоне, используемом, чтобы сгенерировать отчет. Примените стиль шаблонов к объекту Text или в качестве второго аргумента в конструкторе Object Text или путем установки свойства StyleName на стиль шаблонов.
Чтобы задать стиль, используйте синтаксис каскадной таблицы стилей (CSS). Используйте селектор на элементе span, чтобы задать имя стиля. Этот CSS задает стиль под названием Pass.
span.Pass {
font-family: "Times New Roman", Times, serif;
color: green;
}
Можно использовать любые свойства CSS и селекторы в шаблонах HTML. Для шаблонов PDF можно использовать подмножество свойств CSS и селекторов. Смотрите Изменяют Стили в Шаблонах PDF.
Примените стиль шаблонов к объекту Text или в качестве второго аргумента в конструкторе Object Text или путем установки свойства StyleName на стиль шаблонов. Предположим, что вы задали стили под названием Body, Pass и Fail в шаблоне для вашего отчета. Можно затем применить стили.
import mlreportgen.dom.*; passed = rand(1) >= 0.5; rpt = Document('MyReport','html','MyTemplate'); t1 = Text('Test status: '); t1.StyleName = 'Body'; t1.WhiteSpace = 'preserve'; if passed status = 'Passed'; statusStyle = 'Pass'; else status = 'Failed'; statusStyle = 'Fail'; end t2 = Text(status,statusStyle); statusPara = Paragraph(t1); append(statusPara,t2); append(rpt, statusPara); close(rpt); rptview(rpt.OutputPath);
Можно использовать программируемые форматы, чтобы заменить форматы, заданные в основанном на шаблоне стиле. Предположим, что вы задаете стиль под названием AlertLevel в вашем шаблоне, который выбирает цвет к зеленому. Можно заменить стиль в программе отчета, чтобы выбрать цвет на основе текущего аварийного уровня:
t = Text('Danger!','AlertLevel'); t.Color = 'red';
mlreportgen.dom.Bold | mlreportgen.dom.CharEntity | mlreportgen.dom.FontFamily | mlreportgen.dom.FontSize | mlreportgen.dom.Italic | mlreportgen.dom.Strike | mlreportgen.dom.Text | mlreportgen.dom.Underline