mlreportgen.dom.Text class

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

Описание

Текст для включения в элемент документа

Конструкция

textObj = Text() создает пустой текстовый объект.

textObj = Text(text) создает текстовый объект, содержащий указанный текст.

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

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

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

Массив графиков, содержащий текст

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

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

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

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

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

Текст, возвращенный как mlreportgen.dom.Text объект.

Свойства

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

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

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

Пример: 'blue'

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

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

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

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

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

Пример: 'blue'

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

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

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

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

Установка 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'

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

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

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

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

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

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

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

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

Массив ячеек из объектов формата DOM, задающий формат текста.

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

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

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 формат объекта, который задает тип и цвет подчеркивания.

Чтобы задать, как обработать пустое пространство, используйте одно из следующих значений. The WhiteSpace свойство не применяется к формату PDF для Text объекты.

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

'normal'

Не сохраняет пустое пространство и пропуски линий

Слово и HTML

'nowrap'

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

HTML

'preserve'

Сохраняет пустое пространство. Текст переносится при необходимости и на пропусках линий. Действует как <pre-wrap> установка в HTML.

Слово и HTML

Подробнее см. ниже.

'pre'

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

HTML

'pre-line'

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

HTML

'pre-wrap'

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

HTML

Если необходимо просмотреть выход HTML в MATLAB® браузер и вы хотите сохранить пустое пространство и перенести текст только на пропуски линий, используйте preserve установка, а не pre настройка.

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

Методы

Используйте Text.append и Text.clone методы так же, как вы используете Paragraph.append и Paragraph.clone методы.

Метод

Цель

append

Добавьте пользовательский элемент к этому текстовому объекту.

clone

Клонирование этого текстового объекта