Пакет: mlreportgen.dom
Суперклассы:
Отформатированный блок текста (абзац)
Используйте mlreportgen.dom.Paragraph
объект задать абзац. Можно добавить элементы документа, такие как изображение, к абзацу.
создает абзац, содержащий paragraphObj
= Paragraph(text
)mlreportgen.dom.Text
объект с текстом, заданным text
.
создает абзац, указывающий, что это разрабатывает. Стиль задан paragraphObj
= Paragraph(text
,styleName
)styleName
должен быть задан в шаблоне, используемом в элементе документа, к которому добавлен этот абзац.
создает абзац, содержащий элемент документаparagraphObj
= Paragraph(docElementObj
), указанный docElementObj
(например, изображение).
text
— Текст абзацаТекст абзаца, заданный как вектор символов.
styleName
— Разработайте для абзацаИмя стиля, заданного как вектор символов. Стиль должен быть задан в шаблоне, используемом, чтобы создать документ, к которому добавлен этот абзац.
docElementObj
— Элемент документа, чтобы включать в новый абзацОбъект DOM, чтобы включать в абзац. Можно задать эти Объекты DOM:
mlreportgen.dom.ExternalLink
mlreportgen.dom.Image
mlreportgen.dom.InternalLink
mlreportgen.dom.Text
mlreportgen.dom.LinkTarget
paragraphObj
— Абзацmlreportgen.dom.Paragraph
объектАбзац, представленный mlreportgen.dom.Paragraph
объект.
BackgroundColor
BackgroundColor Цвет фона, заданный как также:
Имя цвета. Имя должно быть названием цвета CSS. См. https://www.crockford.com/wrrrld/color.html.
Шестнадцатеричный RGB (истинный цвет) значение как #RRGGBB
. Например, #0000ff
оттенок синего цвета.
Bold
— Опция, чтобы использовать полужирный в тексте[]
(значение по умолчанию) | логическое значениеЧтобы сделать текст полужирным, установите это свойство на true
или 1
. Если это свойство пусто и StyleName
свойство для этого элемента документа задает стиль таблицы стилей, вес текста определяется тем стилем. Установка Bold
свойство добавляет соответствующий mlreportgen.dom.Bold
объект формата к Style
свойство этого элемента документа. Удаление Bold
установка свойства удаляет объект.
Типы данных: логический
Color
TextColor Цвет текста, заданный как также:
Имя цвета. Имя должно быть названием цвета CSS. См. https://www.crockford.com/wrrrld/color.html.
Шестнадцатеричный RGB (истинный цвет) значение как #RRGGBB
. Например, #0000ff
оттенок синего цвета.
Children
— Дочерние элементы этого абзацаmlreportgen.dom.Element
объектыЭто дочерние элементы списков свойств только для чтения, такие как изображение (mlreportgen.dom.Image
) объект, что абзац содержит.
CustomAttributes
— Пользовательские атрибуты элемента документа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
— Размер шрифта для текста абзацаУстановка FontSize
свойство добавляет соответствующий mlreportGen.dom.FontSize
объект формата к Style
свойство для этого элемента документа. Удаление FontSize
установка свойства удаляет объект.
Задайте размер шрифта в форме valueUnits
, где Units
сокращение от модулей. Используйте одно из этих сокращений:
px
— пиксели (значение по умолчанию)
cm
'centimeters'
in
'inches'
mm
— миллиметры
pc
— цицеро
pt
'points'
HAlign
— Выравнивание по горизонтали этого абзацаВыравнивание по горизонтали для абзаца, относительно полей страницы или границ ячейки таблицы, заданных как одно из этих значений.
Значение | Описание | Поддерживаемые Выходные типы |
---|---|---|
| Сосредоточьте абзац | Все выходные типы |
| Распределите все символы одинаково | Word |
| Выровняйте сторону по левому краю абзаца на левой стороне страницы и правой стороне абзаца на правой стороне страницы | Все выходные типы |
| Используйте самую широкую длину Kashida | Word |
| Используйте самую низкую длину Kashida | Word |
| Используйте среднюю длину Kashida | Word |
| Выровняйте абзац по левому краю | Все выходные типы |
| Выровняйте абзац по правому краю | Все выходные типы |
| Тайское выравнивание языка | Word |
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
— Форматирование абзацаМассив ячеек объектов формата DOM, который задает форматы для этого стиля абзаца.
StyleName
— Имя стиля абзацаСтиль задан 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
объект.
Добавьте абзац с текстом и другого с внешней ссылкой.
import mlreportgen.dom.* doc = Document('mydoc','html'); p1 = Paragraph('This will be bold text'); p1.Bold = true; link = ExternalLink('https://www.mathworks.com/', 'MathWorks'); p2 = Paragraph(link); p2.BackgroundColor = 'yellow'; append(doc,p1); append(doc,p2); close(doc); rptview('mydoc','html');
У вас есть модифицированная версия этого примера. Вы хотите открыть этот пример со своими редактированиями?
1. Если смысл перевода понятен, то лучше оставьте как есть и не придирайтесь к словам, синонимам и тому подобному. О вкусах не спорим.
2. Не дополняйте перевод комментариями “от себя”. В исправлении не должно появляться дополнительных смыслов и комментариев, отсутствующих в оригинале. Такие правки не получится интегрировать в алгоритме автоматического перевода.
3. Сохраняйте структуру оригинального текста - например, не разбивайте одно предложение на два.
4. Не имеет смысла однотипное исправление перевода какого-то термина во всех предложениях. Исправляйте только в одном месте. Когда Вашу правку одобрят, это исправление будет алгоритмически распространено и на другие части документации.
5. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.