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. Например, #0000ff оттенок синего цвета.

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

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

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

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

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

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

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

Задайте значение в форме 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 установка свойства удаляет объект.

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

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

  • cm 'centimeters'

  • in 'inches'

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

  • pc — цицеро

  • pt 'points'

  • px 'pixels'

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

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

'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 установка свойства удаляет объект.

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

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

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

  • cm 'centimeters'

  • in 'inches'

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

  • pc — цицеро

  • pt 'points'

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

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

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

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

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

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

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

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

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

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

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

DOM генерирует уникальный для сеанса тег, когда он создает элемент документа. Структурируйте тег как 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

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

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

clone

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

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