mlreportgen.dom.Heading1 class

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

Создайте абзац Heading1

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

Описание

Создайте mlreportgen.dom.Heading1 объект абзаца.

Конструкция

headingObj = Heading1() создает пустой Heading1 объект.

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

headingObj = Heading1(text,styleName) создает заголовок с помощью заданного стиля.

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

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

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

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

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

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

  • ExternalLink

  • Image

  • InternalLink

  • LinkTarget

  • Text

Свойства

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

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

  • Имя цвета. Имя должно быть названием цвета 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.CustomAttribute объекты. Используйте пользовательские атрибуты, поддержанные выходным форматом.

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

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

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

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

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

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

  • cm 'centimeters'

  • in 'inches'

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

  • pc — цицеро

  • pt 'points'

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' — Не используйте перечеркивание.

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

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

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

Объекты формата, которые задают формат элемента документа.

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

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

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

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

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

clone

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

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

Примеры

свернуть все

Открыть скрипт

В этом примере показано, как добавить три уровня заголовков, каждый отформатированный согласно его уровню. Этот пример вставляет три направляющихся объекта в документ: Heading1, Heading2, и Heading3.

import mlreportgen.dom.*;
d = Document('mydoc','docx');
open(d);

title = append(d, Paragraph('Document Title'));
title.Bold = true;
title.FontSize = '28pt';

h1 = append(d,Heading1('Chapter 1'));
h1.Style = {PageBreakBefore(true)};
p1 = append(d,Paragraph('Hello World'));

h2 = append(d,Heading2('Section 1.1'));
p2 = append(d,Paragraph('Text for this section.'));

h3 = append(d,Heading3('My Subsection 1.1.a'));
p3 = append(d,Paragraph('Text for this subsection'));

close(d);
rptview(d.OutputPath);

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

| | | | | |

Темы

Введенный в R2016a

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