Пакет: mlreportgen.dom
Суперклассы:
Создайте абзац Heading4
Создайте mlreportgen.dom.Heading4
объект абзаца.
создает пустой headingObj
= Heading4()Heading4
объект.
создает заголовок, содержащий заданный текст.headingObj
= Heading4(text
)
создает заголовок с помощью заданного стиля.headingObj
= Heading4(text
,styleName
)
создает заголовок, содержащий заданный Объект DOM.headingObj
= Heading4(domObj
)
text
— Текст заголовкаТекст заголовка, заданный как вектор символов.
styleName
— Разработайте для заголовкаИмя стиля, заданного как вектор символов. Стиль должен быть задан в шаблоне, используемом, чтобы создать документ, который содержит этот заголовок.
domObj
— Объект DOM, чтобы включать в заголовокmlreportgen.dom.ExternalLink
возразите | mlreportgen.dom.Image
возразите | mlreportgen.dom.InternalLink
возразите | mlreportgen.dom.LinkTarget
возразите | mlreportgen.dom.Text
объектОбъект DOM, чтобы включать в заголовок, заданный как любой из этих типов Объекта DOM:
ExternalLink
Image
InternalLink
LinkTarget
Text
BackgroundColor
BackgroundColor Цвет фона, заданный как также:
Имя цвета. Имя должно быть названием цвета CSS. См. https://www.crockford.com/wrrrld/color.html.
Шестнадцатеричный RGB (истинный цвет) значение как #RRGGBB
. Например, #0000ff
оттенок синего цвета.
Bold
— Опция, чтобы использовать полужирный в тексте[]
(значение по умолчанию) | логическое значениеЧтобы сделать текст полужирным, установите это свойство на true
или 1
. Если это свойство пусто и StyleName
свойство для этого элемента документа задает стиль таблицы стилей, вес текста определяется тем стилем. Установка Bold
свойство добавляет соответствующий mlreportgen.dom.Bold
объект формата к Style
свойство этого элемента документа. Удаление Bold
установка свойства удаляет объект.
Типы данных: логический
Children
— Дочерние элементы этого объектаЭтот дочерний элемент списков свойств только для чтения элементы этого объекта.
Color
TextColor Цвет текста, заданный как также:
Имя цвета. Имя должно быть названием цвета CSS. См. https://www.crockford.com/wrrrld/color.html.
Шестнадцатеричный RGB (истинный цвет) значение как #RRGGBB
. Например, #0000ff
оттенок синего цвета.
CustomAttributes
— Пользовательские атрибуты этого элементаmlreportgen.dom.CustomAttribute
объектыПользовательские атрибуты этого элемента, указанного как массив mlreportgen.dom.CustomAttribute
объекты. Используйте пользовательские атрибуты, поддержанные выходным форматом.
FirstLineIndent
— Объем добавления отступа для первой линии абзацаСумма, которой можно расположить первую линию с отступом этого абзаца относительно последующих линий. Чтобы создать выступ, в котором все линии располагаются с отступом за исключением первой линии, используют отрицательное число.
Задайте значение в форме valueUnits
, где Units
сокращение от модулей. Используйте одно из этих сокращений от модулей.
px
— пиксели (значение по умолчанию)
cm
'centimeters'
in
'inches'
mm
— миллиметры
pc
— цицеро
pt
'points'
FontFamilyName
— Имя семейства шрифтов для текстаИмя семейства шрифтов.
Чтобы задать замены на этот шрифт, не устанавливайте это свойство. Вместо этого создайте и добавьте mlreportgen.dom.FontFamily
возразите против Style
свойство этого элемента документа.
Установка FontFamilyName
свойство добавляет соответствующий mlreportGen.dom.FontFamily
объект формата к Style
свойство для этого элемента документа. Установка FontFamilyName
свойство совпадает с установкой FontName
свойство mlreportgen.dom.FontFamily
. Удаление FontFamilyName
установка свойства удаляет объект.
FontSize
— Размер шрифта для текстаЕсли необходимо задать замены на этот шрифт, не устанавливайте это свойство. Вместо этого создайте и добавьте mlreportgen.dom.FontFamily
возразите против Style
свойство этого элемента документа.
Установка FontSize
свойство добавляет соответствующий mlreportGen.dom.FontSize
объект формата к Style
свойство для этого элемента документа. Удаление FontSize
установка свойства удаляет объект.
Размер шрифта для текста, в форме valueUnits
, где Units
сокращение от модулей. Используйте одно из этих сокращений от модулей:
px
— пиксели (значение по умолчанию)
cm
'centimeters'
in
'inches'
mm
— миллиметры
pc
— цицеро
pt
'points'
Id
— ID для элемента документаID для этого элемента документа, указанного как вектор символов. DOM генерирует уникальный идентификатор сеанса, когда он создает элемент документа. Можно задать собственный ID.
Italic
— Опция, чтобы использовать курсив в тексте[]
(значение по умолчанию) | логическое значениеЧтобы использовать курсив в тексте, установите это свойство на true
. Если это свойство пусто и StyleName
свойство для этого элемента документа задает стиль таблицы стилей, наклон текста определяется тем стилем. Установка Italic
свойство добавляет соответствующий mlreportgen.dom.Italic
объект формата к Style
свойство этого элемента документа. Удаление Italic
установка свойства удаляет объект.
Типы данных: логический
OuterLeftMargin
— Оставленное добавление отступа для абзацаПробел между левой внешней границей этого абзаца и левой внутренней границей его контейнера. Это эквивалентно левому свойству добавления отступа абзаца Word Microsoft®.
Чтобы расположить абзац с отступом от обоих левое и правое поле страницы, не устанавливайте это свойство. Вместо этого добавьте к Style
свойство этого абзаца mlreportgen.dom.OuterMargin
объект, задающий левые и правые добавления отступа.
Установка OuterLeftMargin
свойство добавляет соответствующий mlreportGen.dom.OuterMargin
объект формата к Style
свойство для этого элемента документа. Удаление OuterLeftMargin
установка свойства удаляет объект.
Значение имеет форму valueUnits
, где Units
сокращение от модулей. Используйте одно из этих сокращений от модулей:
px
— пиксели (значение по умолчанию)
cm
'centimeters'
in
'inches'
mm
— миллиметры
pc
— цицеро
pt
'points'
OutlineLevel
— Обрисуйте в общих чертах уровень этого абзаца[]
(значение по умолчанию) | числовое значениеУстановка OutlineLevel
свойство заставляет этот абзац быть включенным в автоматически сгенерированные основы, такие как оглавление. Значение задает уровень абзаца в оглавлении. Например, чтобы заставить абзац появиться как Heading 1
(Word) или h1
(HTML), набор OutlineLevel
к 1
.
Типы данных: int32
Parent
— Родительский элемент элемента документаЭто списки свойств только для чтения родительский элемент этого элемента документа.
Strike
— Текстовое перечеркивание'none'
| 'single'
| 'double'
Текстовое перечеркивание, заданное как одно из этих значений:
'none'
— Не используйте перечеркивание.
'single'
— Используйте одну строку в перечеркивании.
'double'
— Используйте двойную линию в перечеркивании для документов Word.
Установка Strike
свойство добавляет соответствующий mlreportGen.dom.Strike
объект формата к Style
свойство для этого элемента документа. Удаление Strike
установка свойства удаляет объект.
Style
— Спецификация форматаОбъекты формата, которые задают формат элемента документа.
StyleName
— Разработайте, чтобы применяться из таблицы стилейИмя стиля, чтобы применяться из таблицы стилей, заданной как вектор символов.
Tag
— Пометьте для элемента документаПометьте для элемента документа, указанного как вектор символов.
DOM генерирует уникальный для сеанса тег, когда он создает элемент документа. Структурируйте тег как class:id
, где class
класс элемента и id
значение Id
свойство. Можно задать тег, чтобы заменить сгенерированный тег. Определение вашего собственного тега может облегчить идентифицировать, где проблема произошла во время генерации документов.
Underline
— Тип подчеркивания, если таковые имеются, для текста[]
(значение по умолчанию) | вектор символовМожно задать один из следующих типов подчеркиваний.
Ограничьте значение | Описание | Поддерживаемые Выходные типы |
---|---|---|
| Пунктирное подчеркивание | Word |
| Линия с тяжелыми тире | Word |
| Линия с длинными тире | Word |
| Линия с тяжелыми длинными тире | Word |
| Линия с тяжелыми тире с двумя точками между тире | Word |
| Тяжелая штрихпунктирная линия | Word |
| Пунктирная линия | Word |
| Толстая пунктирная линия | Word |
| Точечный штриховой пунктир | Word |
| Точечный точечный штриховой пунктир | Word |
| Тяжелый точечный штриховой пунктир | Word |
| Двойная линия | Word |
| Не используйте подчеркивание | Все выходные типы |
| Одна строка | Все выходные типы |
| Толстая линия | Word |
| Волнистая линия | Word |
| Удвойте волнистую линию | Word |
| Тяжелый волнистый | Word |
| Подчеркните непробелы только | Word |
Если это свойство пусто и StyleName
свойство этого элемента документа задает стиль таблицы стилей, тип подчеркивания определяется тем стилем.
Чтобы задать цвет, а также тип подчеркивания, не устанавливайте Underline
свойство. Вместо этого установите Style
свойство этого элемента документа включать mlreportgen.dom.Underline
объект формата, который задает желаемый тип подчеркивания и цвет.
Установка Underline
свойство добавляет соответствующий mlreportgen.dom.Underline
объект формата к Style
свойство для этого элемента документа. Удаление Underline
установка свойства удаляет объект.
WhiteSpace
— Пробел и разрывы строки в тексте[]
(значение по умолчанию) | вектор символовЧтобы задать, как обработать пробел, используйте одно из этих значений.
Значение | Описание | Поддерживаемые Выходные типы |
---|---|---|
| Для HTML и PDF, удаляет пробелы вначале и конец текста. Несколько пробелов в рамках текста выходят из строя к одиночному пробелу. Для Word, удаляет пробелы вначале и конец текста. | Все выходные типы |
| Последовательности пробела выходят из строя в один пробел. Текст никогда не переносится к следующей строке. | HTML |
| Пробелы консервов и переводы строки. Законы как | Все выходные типы |
| Пробел консервов. Текст переносится только на разрывах строки. Законы как | HTML и PDF |
| Последовательности пробела выходят из строя в один пробел. Текст переносится. | HTML и PDF |
| Пробел консервов. Текст переносится когда необходимый и на разрывах строки | HTML и PDF |
Установка WhiteSpace
свойство добавляет соответствующий WhiteSpace
объект формата к Style
свойство. Удаление WhiteSpace
установка свойства удаляет WhiteSpace
объект.
В этом примере показано, как добавить три уровня заголовков, каждый отформатированный согласно его уровню. Этот пример вставляет три направляющихся объекта в документ: Heading1
, Heading2
, и Heading3
.
import mlreportgen.dom.*; d = Document('mydoc','docx'); open(d); title = append(d, Paragraph('Document Title')); title.Bold = true; title.FontSize = '28pt'; h1 = append(d,Heading1('Chapter 1')); h1.Style = {PageBreakBefore(true)}; p1 = append(d,Paragraph('Hello World')); h2 = append(d,Heading2('Section 1.1')); p2 = append(d,Paragraph('Text for this section.')); h3 = append(d,Heading3('My Subsection 1.1.a')); p3 = append(d,Paragraph('Text for this subsection')); close(d); rptview(d.OutputPath);
mlreportgen.dom.Heading
| mlreportgen.dom.Heading1
| mlreportgen.dom.Heading2
| mlreportgen.dom.Heading3
| mlreportgen.dom.Heading5
| mlreportgen.dom.Heading6
| mlreportgen.dom.Paragraph
У вас есть модифицированная версия этого примера. Вы хотите открыть этот пример со своими редактированиями?
1. Если смысл перевода понятен, то лучше оставьте как есть и не придирайтесь к словам, синонимам и тому подобному. О вкусах не спорим.
2. Не дополняйте перевод комментариями “от себя”. В исправлении не должно появляться дополнительных смыслов и комментариев, отсутствующих в оригинале. Такие правки не получится интегрировать в алгоритме автоматического перевода.
3. Сохраняйте структуру оригинального текста - например, не разбивайте одно предложение на два.
4. Не имеет смысла однотипное исправление перевода какого-то термина во всех предложениях. Исправляйте только в одном месте. Когда Вашу правку одобрят, это исправление будет алгоритмически распространено и на другие части документации.
5. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.