mlreportgen.dom. Класс абзаца

Пакет: mlreportgen.dom
Суперклассы:

Отформатированный блок текста (абзац)

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

Описание

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

Конструкция

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

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

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

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

развернуть все

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

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

Объект DOM, чтобы включать в абзац. Можно задать эти Объекты DOM:

  • mlreportgen.dom.ExternalLink

  • mlreportgen.dom.Image

  • mlreportgen.dom.InternalLink

  • mlreportgen.dom.Text

  • mlreportgen.dom.LinkTarget

Выходные аргументы

развернуть все

Абзац, представленный объектом mlreportgen.dom.Paragraph.

Свойства

развернуть все

Цвет фона, заданный как также:

  • Имя цвета. Имя должно быть названием цвета CSS. См. https://www.crockford.com/wrrrld/color.html.

  • Шестнадцатеричный RGB (истинный цвет) значение как #RRGGBB. Например, #0000ff является оттенком синего цвета.

Чтобы сделать текст полужирным, установите это свойство на true или 1. Если это свойство пусто, и свойство StyleName для этого элемента документа задает стиль таблицы стилей, вес текста определяется тем стилем. Установка свойства Bold добавляет соответствующий объект формата mlreportgen.dom.Bold в свойство Style этого элемента документа. Удаление установки свойства Bold удаляет объект.

Типы данных: логический

Цвет текста, заданный как также:

  • Имя цвета. Имя должно быть названием цвета CSS. См. https://www.crockford.com/wrrrld/color.html.

  • Шестнадцатеричный RGB (истинный цвет) значение как #RRGGBB. Например, #0000ff является оттенком синего цвета.

Это дочерние элементы списков свойств только для чтения, такие как объект (mlreportgen.dom.Image) изображений, что абзац содержит.

Выходной формат должен поддержать пользовательские атрибуты этого элемента документа.

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

Задайте значение в форме valueUnits, где Units является сокращением от модулей. Используйте одно из этих сокращений от модулей.

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

  • cm — 'centimeters'

  • \in 'inches'

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

  • pc — цицеро

  • pt — 'points'

Имя семейства шрифтов.

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

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

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

Задайте размер шрифта в форме valueUnits, где Units является сокращением от модулей. Используйте одно из этих сокращений:

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

  • cm — 'centimeters'

  • \in 'inches'

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

  • pc — цицеро

  • pt — 'points'

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

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

'center'

Сосредоточьте абзац

Все выходные типы

'distribute'

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

Word

'justify'

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

Все выходные типы

'KashidaHigh'

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

Word

'KashidaLow'

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

Word

'KashidaMedium'

Используйте среднюю длину Kashida

Word

'left'

Выровняйте абзац по левому краю

Все выходные типы

'right'

Выровняйте абзац по правому краю

Все выходные типы

'ThaiDistribute'

Тайское выравнивание языка

Word

ID для этого элемента документа, указанного как вектор символов. DOM генерирует уникальный идентификатор сеанса, когда он создает элемент документа. Можно задать собственный ID.

Чтобы использовать курсив для текста, установите это свойство на true. Если это свойство пусто, и свойство StyleName для этого элемента документа задает стиль таблицы стилей, наклон текста определяется тем стилем. Установка свойства Italic добавляет соответствующий объект формата mlreportgen.dom.Italic в свойство Style этого элемента документа. Удаление установки свойства Italic удаляет объект.

Типы данных: логический

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

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

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

Значение имеет форму valueUnits, где Units является сокращением от модулей. Используйте одно из этих сокращений от модулей:

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

  • cm — 'centimeters'

  • \in 'inches'

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

  • pc — цицеро

  • pt — 'points'

Установка свойства OutlineLevel заставляет этот абзац быть включенным в автоматически сгенерированные основы, такие как оглавление. Значение задает уровень абзаца в оглавлении. Например, чтобы заставить абзац появиться как Heading 1 (Word) или h1 (HTML), установите OutlineLevel на 1.

Типы данных: int32

Это списки свойств только для чтения родительский элемент этого элемента документа.

Текстовое перечеркивание, заданное как одно из этих значений:

  • 'none' Не используйте перечеркивание.

  • единственный Используйте одну строку для перечеркивания.

  • 'double' Используйте двойную строку для перечеркивания для документов Word.

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

Массив ячеек объектов формата DOM, который задает форматы для этого стиля абзаца.

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

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

Уникальный идентификатор сеанса сгенерирован как часть создания элемента документа. Сгенерированный тег имеет форму CLASS:ID, где CLASS является классом элемента, и ID является значением свойства Id объекта. Можно задать тег, чтобы заменить сгенерированный тег.

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

Можно задать один из следующих типов подчеркиваний.

Ограничьте значениеОписаниеПоддерживаемые Выходные типы

'dash'

Пунктирное подчеркивание

Word

'dashedHeavy'

Строка с тяжелыми тире

Word

'dashLong'

Строка с длинными тире

Word

'dashLongHeavy'

Строка с тяжелыми длинными тире

Word

'dashDotDotHeavy'

Строка с тяжелыми тире с двумя точками между тире

Word

'dashDotHeavy'

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

Word

'dotted'

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

Word

'dottedHeavy'

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

Word

'dotDash'

Точечный штриховой пунктир

Word

'dotDotDash'

Точечный точечный штриховой пунктир

Word

'dashDotHeavy'

Тяжелый точечный штриховой пунктир

Word

'double'

Двойная строка

Word

'none'

Не используйте подчеркивание

Все выходные типы

'single'

Одна строка

Все выходные типы

'thick'

Толстая строка

Word

'wave'

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

Word

'waveyDouble'

Удвойте волнистую строку

Word

'waveyHeavy'

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

Word

'words'

Подчеркните непробелы только

Word

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

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

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

Чтобы задать, как обработать пробел, используйте одно из этих значений.

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

'normal' (значение по умолчанию)

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

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

Все выходные типы

'nowrap'

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

HTML

'preserve'

Пробелы консервов и переводы строки. Законы как <pre> помечают в HTML.

Все выходные типы

'pre'

Пробел консервов. Текст переносится только на разрывах строки. Законы как <pre> помечают в HTML.

HTML и PDF

'pre-line'

Последовательности пробела выходят из строя в один пробел. Текст переносится.

HTML и PDF

'pre-wrap'

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

HTML и PDF

Установка свойства WhiteSpace добавляет соответствующий объект формата WhiteSpace в свойство Style. Удаление установки свойства WhiteSpace удаляет объект WhiteSpace.

Методы

Метод

Цель

append

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

clone

Скопируйте абзац.

Примеры

свернуть все

Скрипт Open Live Script

Добавьте абзац с текстом и другого с внешней ссылкой. 

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');

Смотрите также

| |

Темы

Документация MATLAB Report Generator
Поддержка
Для просмотра документации необходимо авторизоваться на сайте