Пакет: 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. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.