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