Пакет: mlreportgen.dom
Суперклассы:
Создайте абзац Heading1
Создайте mlreportgen.dom.Heading1
объект абзаца.
создает пустой headingObj
= Heading1()Heading1
объект.
создает заголовок, содержащий заданный текст.headingObj
= Heading1(text
)
создает заголовок с помощью заданного стиля.headingObj
= Heading1(text
,styleName
)
создает заголовок, содержащий заданный Объект DOM.headingObj
= Heading1(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
.
Установка BackgroundColor
свойство добавляет соответствующий mlreportgen.dom.BackgroundColor
объект формата к Style
свойство. Установка BackgroundColor
свойство к пустому значению удаляет объект.
Пример: 'blue'
Пример: '#0000ff'
Bold
— Использовать ли полужирный в тексте[]
(значение по умолчанию) | true
или 1
| false
или 0
Использовать ли полужирный в тексте в виде числового или логического 1
TRUE
) или 0
ложь
). Сделать текст полужирным, набор Bold
к true
или 1
.
Установка Bold
свойство добавляет соответствующий mlreportgen.dom.Bold
объект формата к Style
свойство. Установка Bold
свойство к пустому значению удаляет объект.
Children
— Дочерние элементы элемента документаДочерние элементы этого элемента документа в виде массива Объектов DOM. Это свойство доступно только для чтения.
Color
TextColor []
(значение по умолчанию) | вектор символов | строковый скалярЦвет текста в виде вектора символов или строкового скаляра, который состоит из названия цвета CSS (см. https://www.crockford.com/wrrrld/color.html), или шестнадцатеричный RGB (истинный цвет) значение в форме #RRGGBB
.
Установка Color
свойство добавляет соответствующий mlreportgen.dom.Color
объект формата к Style
свойство. Установка Color
свойство к пустому значению удаляет объект.
Пример: 'blue'
Пример: '#0000ff'
CustomAttributes
— Пользовательские атрибуты этого элементаmlreportgen.dom.CustomAttribute
объектыПользовательские атрибуты этого элемента в виде массива mlreportgen.dom.CustomAttribute
объекты. Используйте пользовательские атрибуты, поддержанные выходным форматом.
FirstLineIndent
— Объем добавления отступа для первой линии абзаца[]
| вектор символов | строковый скалярОбъем добавления отступа для линии кулака этого абзаца в виде вектора символов или строкового скаляра, который состоит из номера, сопровождаемого сокращением от единицы измерения. Например, '0.5 дюйма' задает половину дюйма. Допустимые сокращения:
px
— пиксели (значение по умолчанию)
cm
'centimeters'
in
'inches'
mm
— миллиметры
pc
— цицеро
pt
'points'
Объем добавления отступа является суммой, которой можно расположить первую линию с отступом этого абзаца относительно последующих линий. Чтобы создать выступ, где все линии располагаются с отступом за исключением первой линии, используйте отрицательное число.
Установка FirstLineIndent
свойство добавляет соответствующий mlreportgen.dom.FirstLineIndent
объект формата к Style
свойство для этого элемента документа. Установка FirstLineIndent
свойство к пустому значению удаляет объект.
Пример: '0.5in'
FontFamilyName
— Имя семейства шрифтов для текста[]
| вектор символов | строковый скалярИмя семейства шрифтов, чтобы использовать в тексте в виде вектора символов или строкового скаляра.
Установка FontFamilyName
свойство добавляет соответствующий mlreportgen.dom.FontFamily
объект формата к Style
свойство. Установка FontFamilyName
свойство совпадает с установкой FontName
свойство mlreportgen.dom.FontFamily
объект. Установка FontFamilyName
свойство к пустому значению удаляет объект.
Чтобы задать замены на шрифт, не задавайте семейство шрифтов путем установки этого свойства. Вместо этого создайте и добавьте mlreportgen.dom.FontFamily
возразите против Style
свойство.
Пример: 'Courier New'
FontSize
— Размер шрифта для текста[]
(значение по умолчанию) | вектор символов | строковый скалярРазмер шрифта, чтобы использовать в тексте в виде вектора символов или строкового скаляра, который состоит из номера, сопровождаемого сокращением от единицы измерения. Например, '12pt'
задает двенадцать точек. Допустимые сокращения:
px
— пиксели (значение по умолчанию)
cm
'centimeters'
in
'inches'
mm
— миллиметры
pc
— цицеро
pt
'points'
Установка FontSize
свойство добавляет соответствующий mlreportgen.dom.FontSize
объект формата к Style
свойство. Установка FontSize
свойство к пустому значению удаляет объект.
Пример: '12pt'
Id
— ID для элемента документаID для этого элемента документа в виде вектора символов или строкового скаляра. DOM генерирует уникальный идентификатор сеанса, когда он создает элемент документа. Можно задать собственный ID.
Italic
— Использовать ли курсив в тексте[]
(значение по умолчанию) | true
или 1
| false
или 0
Использовать ли курсив в тексте в виде числового или логического 1
TRUE
) или 0
ложь
). Чтобы сделать текстовый курсив, установите Italic
к true
или 1
.
Установка Italic
свойство добавляет соответствующий mlreportgen.dom.Italic
объект формата к Style
свойство. Установка Italic
свойство к пустому значению удаляет объект.
OuterLeftMargin
— Оставленное добавление отступа для абзаца[]
| вектор символов | строковый скалярОставленное добавление отступа для этого абзаца в виде вектора символов или строкового скаляра, который состоит из номера, сопровождаемого единицей измерения. Например, '0.5 дюйма' задает половину дюйма. Допустимые сокращения:
px
— пиксели (значение по умолчанию)
cm
'centimeters'
in
'inches'
mm
— миллиметры
pc
— цицеро
pt
'points'
Левое добавление отступа является пробелом между левой внешней границей этого абзаца и левой внутренней границей его контейнера. Это эквивалентно левому свойству добавления отступа абзаца Word Microsoft®.
Установка OuterLeftMargin
свойство добавляет соответствующий mlreportGen.dom.OuterMargin
объект формата к Style
свойство для этого элемента документа. Установка OuterLeftMargin
свойство к пустому значению удаляет объект.
Чтобы расположить абзац с отступом от обоих левое и правое поле страницы, не устанавливайте это свойство. Вместо этого создайте mlreportgen.dom.OuterMargin
это задает левые и правые добавления отступа, и добавьте объект в Style
свойство этого абзаца.
OutlineLevel
— Обрисуйте в общих чертах уровень абзаца[]
(значение по умолчанию) | целое числоОбрисуйте в общих чертах уровень абзаца в виде целого числа. Установка OutlineLevel
свойство заставляет этот абзац быть включенным в автоматически сгенерированные основы, такие как оглавление. Значение задает уровень абзаца в схеме. Например, чтобы заставить абзац появиться в верхнем уровне в схеме, установите OutlineLevel
свойство к 1
.
Установка OutlineLevel
свойство добавляет соответствующий mlreportgen.dom.OutlineLevel
объект формата к Style
свойство. Установка OutlineLevel
свойство к пустому значению удаляет объект.
Parent
— Родительский элемент элемента документаРодительский элемент этого элемента документа в виде Объекта DOM. Это свойство доступно только для чтения.
Strike
— Текстовое перечеркивание'none'
| 'single'
| 'double'
Текстовое перечеркивание в виде одного из этих значений:
'none'
— Никакое перечеркивание
'single'
— Одна строка
'double'
— Двойная линия (для Word сообщает только),
Установка Strike
свойство добавляет соответствующий mlreportgen.dom.Strike
объект формата к Style
свойство для этого элемента документа. Установка Strike
свойство к пустому значению удаляет объект.
Style
— Спецификация форматаОбъекты формата, которые задают формат элемента документа.
StyleName
— Разработайте, чтобы применяться из таблицы стилейИмя стиля, чтобы применяться из таблицы стилей в виде вектора символов.
Tag
— Пометьте для элемента документаПометьте для этого элемента документа в виде вектора символов.
DOM генерирует уникальный для сеанса тег, когда он создает элемент документа. Структурируйте тег как class:id
, где class
класс элемента и id
значение Id
свойство. Можно задать тег, чтобы заменить сгенерированный тег. Определение вашего собственного тега может облегчить идентифицировать, где проблема произошла во время генерации документов.
Underline
— Тип подчеркивания[]
(значение по умолчанию) | 'single'
| 'none'
| ...Тип подчеркивания в виде одного из значений в этой таблице.
Подчеркните значение | Описание | Поддерживаемые Выходные типы |
---|---|---|
| Одна строка | Все |
| Подчеркните все символы кроме пробелов | Word |
| Двойная линия | Word |
| Толстая линия | Word |
| Пунктирная линия | Word |
| Толстая пунктирная линия | Word |
| Пунктирная линия | Word |
| Линия с тяжелыми тире | Word |
| Линия с длинными тире | Word |
| Линия с тяжелыми длинными тире | Word |
| Точечный штриховой пунктир | Word |
| Тяжелая штрихпунктирная линия | Word |
| Точечный точечный штриховой пунктир | Word |
| Линия с тяжелыми тире с двумя точками между тире | Word |
| Волнистая линия | Word |
| Тяжелый волнистый | Word |
| Удвойте волнистую линию | Word |
| Никакое подчеркивание | Все |
Установка Underline
свойство добавляет соответствующий mlreportgen.dom.Underline
объект формата к Style
свойство. Установка Underline
свойство к пустому значению удаляет объект.
Чтобы задать и цвет и тип подчеркивания, не устанавливайте Underline
свойство. Вместо этого установите Style
свойство включать mlreportgen.dom.Underline
объект формата, который задает тип подчеркивания и цвет.
WhiteSpace
— Как обработать пробел в тексте[]
(значение по умолчанию) | 'normal'
| 'nowrap'
| ...Как обработать пробел в тексте в виде одного из значений в этой таблице.
Значение | Описание | Поддерживаемые Выходные типы |
---|---|---|
| Для HTML и PDF, это значение удаляет пробелы вначале и конец текста. Несколько пробелов в тексте выходят из строя к одиночному пробелу. Для Word это значение удаляет пробелы вначале и конец текста. | Все |
| Последовательности пробела выходят из строя в один пробел. Текст никогда не переносится к следующей строке. | HTML |
| Пробел консервов. Текст переносится только на разрывах строки. Законы как | HTML и PDF |
| Последовательности пробела выходят из строя в один пробел. Текст переносится когда необходимый и на разрывах строки. | HTML и PDF |
| Пробел консервов. Текст переносится когда необходимый и на разрывах строки. | HTML и PDF |
| То же самое как 'пред'. | Все |
Установка WhiteSpace
свойство добавляет соответствующий mlreportgen.dom.WhiteSpace
объект формата к Style
свойство. Установка 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.Heading2
| mlreportgen.dom.Heading3
| mlreportgen.dom.Heading4
| mlreportgen.dom.Heading5
| mlreportgen.dom.Heading6
| mlreportgen.dom.Paragraph
У вас есть модифицированная версия этого примера. Вы хотите открыть этот пример со своими редактированиями?
1. Если смысл перевода понятен, то лучше оставьте как есть и не придирайтесь к словам, синонимам и тому подобному. О вкусах не спорим.
2. Не дополняйте перевод комментариями “от себя”. В исправлении не должно появляться дополнительных смыслов и комментариев, отсутствующих в оригинале. Такие правки не получится интегрировать в алгоритме автоматического перевода.
3. Сохраняйте структуру оригинального текста - например, не разбивайте одно предложение на два.
4. Не имеет смысла однотипное исправление перевода какого-то термина во всех предложениях. Исправляйте только в одном месте. Когда Вашу правку одобрят, это исправление будет алгоритмически распространено и на другие части документации.
5. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.