Можно создать текст путем добавления вектора символов к документу, абзацу, записи таблицы, или перечислить элемент. 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 возразите любому в качестве второго аргумента в Text конструктор Object или путем установки StyleName свойство к стилю шаблонов.
Чтобы задать стиль, используйте синтаксис каскадной таблицы стилей (CSS). Используйте селектор на span элемент, чтобы задать имя стиля. Этот CSS задает стиль под названием Pass.
span.Pass {
font-family: "Times New Roman", Times, serif;
color: green;
}
Можно использовать любые свойства CSS и селекторы в шаблонах HTML. Для шаблонов PDF можно использовать подмножество свойств CSS и селекторов. Смотрите Изменяют Стили в Шаблонах PDF.
Примените стиль шаблонов к Text возразите любому в качестве второго аргумента в Text конструктор Object или путем установки 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