mlreportgen.dom.Paragraph class

Пакет: mlreportgen.dom

Форматированный блок текста

Описание

Использование mlreportgen.dom.Paragraph объект для определения абзаца. Можно добавить элементы документа, такие как изображение, к абзацу.

The mlreportgen.dom.Paragraph класс является handle класс.

Атрибуты класса

ConstructOnLoad
true
HandleCompatible
true

Для получения информации об атрибутах класса см. раздел «Атрибуты класса».

Создание

Описание

paragraphObj = mlreportgen.dom.Paragraph() создает пустой абзац.

пример

paragraphObj = mlreportgen.dom.Paragraph(text) создает абзац, содержащий указанный текст.

paragraphObj = mlreportgen.dom.Paragraph(text,styleName) создает абзац с заданным стилем. Стиль, заданный как styleName свойство должно быть определено в шаблоне, используемом для элемента документа, к которому добавлен этот абзац.

paragraphObj = mlreportgen.dom.Paragraph(docElementObj) создает абзац, содержащий элемент документа, заданный как docElementObj.

Входные параметры

расширить все

Текст абзаца, заданный как вектор символов или строковый скаляр.

Стиль для этого абзаца, заданный как вектор символов или строковый скаляр. Стиль должен быть определен в шаблоне, используемом для создания документа, к которому добавлен этот абзац.

Элемент документа (объект DOM) для включения в абзац. Можно задать следующие объекты DOM:

Свойства

расширить все

Уровень контура абзаца, заданный как целое число. Установка OutlineLevel свойство приводит к тому, что этот абзац включается в автоматически сгенерированные контуры, такие как таблицы содержимого. Значение задает уровень абзаца в контуре. Для примера, чтобы абзац появился на верхнем уровне в контуре, установите OutlineLevel свойство к 1.

Установка OutlineLevel свойство добавляет соответствующее mlreportgen.dom.OutlineLevel форматировать объект в Style свойство. Установка OutlineLevel свойство для пустого значения удаляет объект.

Использовать ли полужирный цвет для текста, заданный как число или логическое 1 (true) или 0 (false). Чтобы сделать текст жирным, установите Bold на true или 1.

Установка Bold свойство добавляет соответствующее mlreportgen.dom.Bold форматировать объект в Style свойство. Установка Bold свойство для пустого значения удаляет объект.

Использовать ли курсив для текста, заданный как числовой или логический 1 (true) или 0 (false). Чтобы сделать текст курсивным, установите Italic на true или 1.

Установка Italic свойство добавляет соответствующее mlreportgen.dom.Italic форматировать объект в Style свойство. Установка Italic свойство для пустого значения удаляет объект.

Цвет текста, заданный как вектор символов или строковый скаляр, который состоит из названия цвета CSS (см. https://www.crockford.com/wrrrld/color.html) или шестнадцатеричного значения RGB (truecolor) в форме #RRGGBB.

Установка Color свойство добавляет соответствующее mlreportgen.dom.Color форматировать объект в Style свойство. Установка Color свойство для пустого значения удаляет объект.

Пример: 'blue'

Пример: '#0000ff'

Цвет фона, заданный как вектор символов или строковый скаляр, который состоит из названия цвета CSS (см. https://www.crockford.com/wrrrld/color.html) или шестнадцатеричного значения RGB (truecolor) в форме #RRGGBB.

Установка BackgroundColor свойство добавляет соответствующее mlreportgen.dom.BackgroundColor форматировать объект в Style свойство. Установка BackgroundColor свойство для пустого значения удаляет объект.

Пример: 'blue'

Пример: '#0000ff'

Тип подчеркивания, заданный как одно из значений в этой таблице.

Подчеркивание значенияОписаниеПоддерживаемые выходные типы

'single'

Одна линия

Все

'words'

Подчеркивайте все символы, кроме пространств

Word

'double'

Двойная линия

Word

'thick'

Толстая линия

Word

'dotted'

Пунктирная линия

Word

'dottedHeavy'

Толстая пунктирная линия

Word

'dash'

Штриховая линия

Word

'dashedHeavy'

Линия с тяжелыми штрихами

Word

'dashLong'

Линия с длинными штрихами

Word

'dashLongHeavy'

Линия с тяжелыми длинными штрихами

Word

'dotDash'

Пунктирная линия

Word

'dashDotHeavy'

Тяжелая штрих-пунктирная линия

Word

'dotDotDash'

Пунктирная линия

Word

'dashDotDotHeavy'

Линия с тяжелыми штрихами с двумя точками между штрихами

Word

'wave'

Волнистая линия

Word

'wavyHeavy'

Тяжеловолнистый

Word

'wavyDouble'

Двойная волнистая линия

Word

'none'

Нет подчеркивания

Все

Установка Underline свойство добавляет соответствующее mlreportgen.dom.Underline форматировать объект в Style свойство. Установка Underline свойство для пустого значения удаляет объект.

Чтобы задать и цвет, и тип подчеркивания, не устанавливайте Underline свойство. Вместо этого установите Style свойство для включения в mlreportgen.dom.Underline формат объекта, который задает тип и цвет подчеркивания.

Как обработать пустое пространство в тексте, заданное как одно из значений в этой таблице.

ЗначениеОписаниеПоддерживаемые выходные типы

'normal'

Для HTML и PDF это значение удаляет пространства в начале и конце текста. Несколько пространства в тексте свернуты в одно пространство.

Для Word это значение удаляет пространства в начале и конце текста.

Все

'nowrap'

Последовательности белого пространства коллапсируют в единое пустое пространство. Текст никогда не переносится в следующую линию.

HTML

'pre'

Сохраняет пустое пространство. Текст переносится только на пропуски линий. Действует как <pre> тег в HTML.

HTML и PDF

'pre-line'

Последовательности белого пространства коллапсируют в единое пустое пространство. Текст переносится при необходимости и на пропусках линий.

HTML и PDF

'pre-wrap'

Сохраняет пустое пространство. Текст переносится при необходимости и на пропусках линий.

HTML и PDF

'preserve'

То же, что и 'pre'.Все

Установка WhiteSpace свойство добавляет соответствующее mlreportgen.dom.WhiteSpace форматировать объект в Style свойство. Установка WhiteSpace свойство для пустого значения удаляет объект.

Имя семейства шрифтов для текста, заданное как вектор символов или строковый скаляр.

Установка FontFamilyName свойство добавляет соответствующее mlreportgen.dom.FontFamily форматировать объект в Style свойство. Установка FontFamilyName свойство совпадает с настройкой FontName свойство mlreportgen.dom.FontFamily объект. Установка FontFamilyName свойство для пустого значения удаляет объект.

Чтобы задать замены для шрифта, не указывайте семейство шрифтов, задав это свойство. Вместо этого создайте и добавьте mlreportgen.dom.FontFamily объект для Style свойство.

Пример: 'Courier New'

Размер шрифта для текста, заданный как вектор символов или строковый скаляр, который состоит из числа, за которым следует сокращение для единицы измерения. Для примера, '12pt' задает двенадцать точек. Допустимые сокращения:

  • px - пиксели (по умолчанию)

  • cm - сантиметров

  • in - дюймы

  • mm - миллиметры

  • pc - picas

  • pt - точки

Установка FontSize свойство добавляет соответствующее mlreportgen.dom.FontSize форматировать объект в Style свойство. Установка FontSize свойство для пустого значения удаляет объект.

Пример: '12pt'

Зачеркивание текста, заданное как одно из следующих значений:

  • 'none' - Без зачеркивания

  • 'single' - Одна линия

  • 'double' - Двойная линия (только для отчетов Word)

Установка Strike свойство добавляет соответствующее mlreportgen.dom.Strike форматировать объект в Style свойство для этого элемента документа. Установка Strike свойство для пустого значения удаляет объект.

Выравнивание по горизонтали для этого абзаца относительно полей страницы или границ камер таблицы в качестве одного из значений в этой таблице.

ЗначениеОписаниеПоддерживаемые выходные типы

'center'

Центрируйте абзац

Все

'distribute'

Распределите все символы одинаково

Word

'justify'

Выровняйте левую часть абзаца в левой части страницы или таблицы и правую часть абзаца в правой части страницы или таблицы.

Все

'KashidaHigh'

Используйте самую широкую длину Кашиды.

Кашида - тип обоснования, используемый для некоторых скоропортящихся скриптов, таких как арабский и персидский.

Word

'KashidaLow'

Используйте самую низкую длину Кашиды

Word

'KashidaMedium'

Используйте среднюю длину Кашиды

Word

'left'

Выровнять абзац влево

Все

'right'

Выравнивание права абзаца

Все

'ThaiDistribute'

Обоснование тайского языка

Word

Установка HAlign свойство добавляет соответствующее mlreportgen.dom.HAlign форматировать объект в Style свойство для этого элемента документа. Установка HAlign свойство для пустого значения удаляет объект.

Левый отступной элемент для этого абзаца, заданный как вектор символов или строковый скаляр, который состоит из числа, за которым следует единица измерения. Для примера '0.5in' задает половину дюйма. Допустимые сокращения:

  • px - пиксели (по умолчанию)

  • cm - сантиметров

  • in - дюймы

  • mm - миллиметры

  • pc - picas

  • pt - точки

Левое углубление является пространством между левым внешним контуром этого абзаца и левым внутренним контуром его контейнера. Это эквивалентно свойству левого отступа Microsoft® Абзац Word.

Установка OuterLeftMargin свойство добавляет соответствующее mlreportGen.dom.OuterMargin форматировать объект в Style свойство для этого элемента документа. Установка OuterLeftMargin свойство для пустого значения удаляет объект.

Чтобы отступить абзац из левого и правого полей страницы, не устанавливайте это свойство. Вместо этого создайте mlreportgen.dom.OuterMargin который задает левое и правое углубления и добавляет объект к Style свойство этого абзаца.

Сумма отступа для первой линии этого абзаца, заданная как вектор символов или строковый скаляр, который состоит из числа, за которым следует сокращение для единицы измерения. Для примера '0.5in' задает половину дюйма. Допустимые сокращения:

  • px - пиксели (по умолчанию)

  • cm - сантиметров

  • in - дюймы

  • mm - миллиметры

  • pc - picas

  • pt - точки

Сумма отступа является суммой, на которую следует отступить от первой линии этого абзаца относительно последующих линий. Чтобы создать висячий отступной элемент, в котором все линии имеют отступы, кроме первой линии, используйте отрицательное число.

Установка FirstLineIndent свойство добавляет соответствующее mlreportgen.dom.FirstLineIndent форматировать объект в Style свойство для этого элемента документа. Установка FirstLineIndent свойство для пустого значения удаляет объект.

Пример: '0.5in'

Имя стиля для форматирования этого абзаца, заданное как вектор символов или строковый скаляр.

Стиль, заданный как StyleName свойство должно быть определено в таблице стилей документа или части документа, к которой добавлен этот абзац. Заданный стиль определяет внешний вид абзаца в выход документе, кроме форматов, заданных Style свойство этого абзаца. Объекты формата, заданные Style переопределение свойств в форматах, определенных в стиле.

Форматы, определяющие стиль этого абзаца, заданные как массив ячеек объектов формата DOM. Форматы переопределяют соответствующие форматы, заданные стилем таблицы стилей, заданным в StyleName свойство.

Пользовательские атрибуты этого абзаца, заданные как массив ячеек mlreportgen.dom.CustomAttribute объекты. Выход должен поддерживать пользовательские атрибуты.

Родительский элемент абзаца, заданный как объект элемента документа. Это свойство доступно только для чтения.

Дочерние элементы этого абзаца, заданные как массив объектов элемента документа. Это свойство доступно только для чтения.

Тег для этого элемента документа, заданный как вектор символов или строковый скаляр.

DOM генерирует тег с уникальным сеансом как часть создания этого объекта. Сгенерированный тег имеет форму CLASS: ID, где CLASS является классом объекта, а 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');
Введенный в R2013b