Пакет: mlreportgen.dom
Суперклассы:
Создайте абзац Heading4
Создайте объект абзаца mlreportgen.dom.Heading4
.
создает пустой объект headingObj
= Heading4()Heading4
.
создает заголовок, содержащий заданный текст.headingObj
= Heading4(text
)
создает заголовок с помощью заданного стиля.headingObj
= Heading4(text
,styleName
)
создает заголовок, содержащий заданный Объект DOM.headingObj
= Heading4(domObj
)
текст
Текст заголовкаТекст заголовка, заданный как вектор символов.
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'
Не используйте перечеркивание.
единственный
Используйте одну строку для перечеркивания.
'double'
Используйте двойную строку для перечеркивания для документов Word.
Установка свойства Strike
добавляет соответствующий объект формата mlreportGen.dom.Strike
в свойство Style
для этого элемента документа. Удаление установки свойства Strike
удаляет объект.
Style
— Спецификация форматаОбъекты формата, которые задают формат элемента документа.
StyleName
— Разработайте, чтобы применяться из таблицы стилейИмя стиля, чтобы применяться из таблицы стилей, заданной как вектор символов.
Тег
Пометьте для элемента документаПометьте для элемента документа, указанного как вектор символов.
Уникальный идентификатор сеанса сгенерирован как часть создания элемента документа. Сгенерированный тег имеет форму 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. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.