mlreportgen.dom.Heading class

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

Уровень переменной использования абзаца заголовка

Описание

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

Совет

Используйте этот класс, если необходимо определить направляющийся уровень во времени выполнения. В противном случае можно использовать Heading1, Heading2, и т.д. классы, чтобы избежать необходимости устанавливать уровень явным образом.

Конструкция

headingObj = Heading(level) создает пустой заголовок на заданном уровне.

headingObj = Heading(level,text) создает заданный заголовок уровня, содержащий заданный текст.

headingObj = Heading(level,text,styleName) создает заданный заголовок уровня, содержащий заданный текст и использующий заданный стиль.

headingObj = Heading(level,domObj) создает заданный заголовок уровня, содержащий заданный Объект DOM.

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

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

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

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

Текст, чтобы использовать в заголовке в виде вектора символов.

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

Объект DOM, чтобы включать в заголовок в виде любого из этих типов Объекта DOM:

  • ExternalLink

  • Image

  • InternalLink

  • LinkTarget

  • Text

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

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

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

Свойства

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

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

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

Пример: 'blue'

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

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

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

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

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

Пример: 'blue'

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

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

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

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

  • cm 'centimeters'

  • in 'inches'

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

  • pc — цицеро

  • pt 'points'

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

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

Пример: '0.5in'

Имя семейства шрифтов, чтобы использовать в тексте в виде вектора символов или строкового скаляра.

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

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

Пример: 'Courier New'

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

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

  • cm 'centimeters'

  • in 'inches'

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

  • pc — цицеро

  • pt 'points'

  • px 'pixels'

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

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

'center'

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

Все

'distribute'

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

Word

'justify'

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

Все

'KashidaHigh'

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

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

Word

'KashidaLow'

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

Word

'KashidaMedium'

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

Word

'left'

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

Все

'right'

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

Все

'ThaiDistribute'

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

Word

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

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

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

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

Оставленное добавление отступа в форме valueUnitsМодули сокращение от модулей. Допустимые сокращения:

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

  • cm 'centimeters'

  • in 'inches'

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

  • pc — цицеро

  • pt 'points'

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

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

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

  • 'none' — Никакое перечеркивание

  • 'single' — Одна строка

  • 'double' — Двойная линия (для Word сообщает только),

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

Массив mlreportgen.dom.DOCXSection объекты, который задает формат для текста.

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

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

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

DOM генерирует уникальный для сеанса тег, когда он создает элемент документа. Структурируйте тег как class:id, где class класс элемента и id значение Id свойство. Можно задать тег, чтобы заменить сгенерированный тег. Определение вашего собственного тега может облегчить идентифицировать, где проблема произошла во время генерации документов.

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

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

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

То же самое как 'пред'.Все

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

Методы

Метод

Цель

append

Используйте Heading.append похожий на то, как вы используете Paragraph.append.

Добавьте содержимое к заголовку.

clone

Используйте Heading.clone похожий на то, как вы используете Paragraph.clone.

Скопируйте заголовок.