Пакет: mlreportgen.dom
Форматированный блок текста
Использование mlreportgen.dom.Paragraph
объект для определения абзаца. Можно добавить элементы документа, такие как изображение, к абзацу.
The mlreportgen.dom.Paragraph
класс является handle
класс.
ConstructOnLoad | true |
HandleCompatible | true |
Для получения информации об атрибутах класса см. раздел «Атрибуты класса».
создает пустой абзац.paragraphObj
= mlreportgen.dom.Paragraph()
создает абзац, содержащий элемент документа, заданный как 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
(false
). Чтобы сделать текст жирным, установите Bold
на true
или 1
.
Установка Bold
свойство добавляет соответствующее mlreportgen.dom.Bold
форматировать объект в Style
свойство. Установка Bold
свойство для пустого значения удаляет объект.
Italic
- Использовать ли курсив для текста[]
(по умолчанию) | true
или 1
| false
или 0
Использовать ли курсив для текста, заданный как числовой или логический 1
(true
) или 0
(false
). Чтобы сделать текст курсивным, установите Italic
на true
или 1
.
Установка Italic
свойство добавляет соответствующее mlreportgen.dom.Italic
форматировать объект в Style
свойство. Установка Italic
свойство для пустого значения удаляет объект.
Color
- Цвет текста[]
(по умолчанию) | символьный вектор | строковый скалярЦвет текста, заданный как вектор символов или строковый скаляр, который состоит из названия цвета CSS (см. https://www.crockford.com/wrrrld/color.html) или шестнадцатеричного значения RGB (truecolor) в форме #RRGGBB
.
Установка Color
свойство добавляет соответствующее mlreportgen.dom.Color
форматировать объект в Style
свойство. Установка Color
свойство для пустого значения удаляет объект.
Пример: 'blue'
Пример: '#0000ff'
BackgroundColor
- Цвет фона[]
(по умолчанию) | символьный вектор | строковый скалярЦвет фона, заданный как вектор символов или строковый скаляр, который состоит из названия цвета CSS (см. https://www.crockford.com/wrrrld/color.html) или шестнадцатеричного значения RGB (truecolor) в форме #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 |
| То же, что и 'pre'. | Все |
Установка 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
- сантиметров
in
- дюймы
mm
- миллиметры
pc
- picas
pt
- точки
Установка 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 |
| Выровняйте левую часть абзаца в левой части страницы или таблицы и правую часть абзаца в правой части страницы или таблицы. | Все |
| Используйте самую широкую длину Кашиды. Кашида - тип обоснования, используемый для некоторых скоропортящихся скриптов, таких как арабский и персидский. | Word |
| Используйте самую низкую длину Кашиды | Word |
| Используйте среднюю длину Кашиды | Word |
| Выровнять абзац влево | Все |
| Выравнивание права абзаца | Все |
| Обоснование тайского языка | Word |
Установка HAlign
свойство добавляет соответствующее mlreportgen.dom.HAlign
форматировать объект в Style
свойство для этого элемента документа. Установка HAlign
свойство для пустого значения удаляет объект.
OuterLeftMargin
- Левое углубление для абзаца[]
| вектор символов | строковый скалярЛевый отступной элемент для этого абзаца, заданный как вектор символов или строковый скаляр, который состоит из числа, за которым следует единица измерения. Для примера '0.5in' задает половину дюйма. Допустимые сокращения:
px
- пиксели (по умолчанию)
cm
- сантиметров
in
- дюймы
mm
- миллиметры
pc
- picas
pt
- точки
Левое углубление является пространством между левым внешним контуром этого абзаца и левым внутренним контуром его контейнера. Это эквивалентно свойству левого отступа Microsoft® Абзац Word.
Установка OuterLeftMargin
свойство добавляет соответствующее mlreportGen.dom.OuterMargin
форматировать объект в Style
свойство для этого элемента документа. Установка OuterLeftMargin
свойство для пустого значения удаляет объект.
Чтобы отступить абзац из левого и правого полей страницы, не устанавливайте это свойство. Вместо этого создайте mlreportgen.dom.OuterMargin
который задает левое и правое углубления и добавляет объект к Style
свойство этого абзаца.
FirstLineIndent
- Сумма отступа для первой линии абзаца[]
| вектор символов | строковый скалярСумма отступа для первой линии этого абзаца, заданная как вектор символов или строковый скаляр, который состоит из числа, за которым следует сокращение для единицы измерения. Для примера '0.5in' задает половину дюйма. Допустимые сокращения:
px
- пиксели (по умолчанию)
cm
- сантиметров
in
- дюймы
mm
- миллиметры
pc
- picas
pt
- точки
Сумма отступа является суммой, на которую следует отступить от первой линии этого абзаца относительно последующих линий. Чтобы создать висячий отступной элемент, в котором все линии имеют отступы, кроме первой линии, используйте отрицательное число.
Установка 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, где CLASS является классом объекта, а ID является значением Id
свойство объекта. Определение собственного значения тега может помочь вам определить, где произошла проблема во время генерации документа.
Id
- идентификатор для этого элемента документаИдентификатор для этого элемента документа, заданный как вектор символов или строковый скаляр. DOM генерирует уникальный идентификатор сеанса при создании элемента документа. Вы можете задать свой собственный идентификатор.
Добавить абзац с текстом и другой с внешней ссылкой.
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. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.