Можно создать текст путем добавления вектора символов к документу, абзацу, записи таблицы, или перечислить элемент. Функция 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