mlreportgen.ppt.Paragraph class

Пакет: mlreportgen.ppt

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

Описание

Используйте объект mlreportgen.ppt.Paragraph Класс для включения абзаца в презентацию PPT API. Абзац может содержать текст или mlreportgen.ppt.Text, mlreportgen.ppt.InternalLink, или mlreportgen.ppt.ExternalLink объекты.

The mlreportgen.ppt.Paragraph класс является handle класс.

Атрибуты класса

HandleCompatible
true
ConstructOnLoad
true

Для получения информации об атрибутах класса см. раздел «Атрибуты класса».

Создание

Описание

paragraphObj = mlreportgen.ppt.Paragraph() создает пустой объект абзаца.

пример

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

paragraphObj = mlreportgen.ppt.Paragraph(pptElementObj) создает абзац, содержащий текст, внутреннюю ссылку или внешнюю ссылку, заданную pptElementObj.

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

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

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

Элемент представления для включения в абзац, заданный как mlreportgen.ppt.Text, mlreportgen.ppt.InternalLink, или mlreportgen.ppt.ExternalLink объект.

Свойства

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

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

Семейство шрифтов для текста в этом абзаце, заданное как вектор символов или строковый скаляр. Укажите шрифт, который отображается в списке шрифтов в Microsoft® PowerPoint®. Чтобы увидеть список шрифтов, в PowerPoint, на вкладке Home, в группе Font, щелкните стреле справа от шрифта.

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

Цвет шрифта для текста в этом абзаце, заданный как вектор символов или строковый скаляр, который состоит из названия цвета CSS или шестнадцатеричного значения RGB.

  • Список названий цвета CSS см. в разделе https://www.crockford.com/wrrrld/color.html.

  • Чтобы задать шестнадцатеричный формат RGB, используйте # в качестве первого символа и двухзначных шестнадцатеричных чисел для красных, зеленых и синих значений. Для примера, '#0000ff' задает синий цвет.

Размер шрифта текста в этом абзаце, заданный как вектор символов или строковый скаляр, который состоит из числа, за которым следует единица измерения. Для примера, '11pt' задает 11 точек. Допустимые сокращения:

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

  • cm - сантиметров

  • in - дюймы

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

  • pc - picas

  • pt - точки

Использовать ли курсив для текста в этом абзаце, заданный как true или false. Настройка true отображает текст курсивом.

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

  • 'single' - Одна горизонтальная линия

  • 'none' - Нет перечеркивающей линии

  • 'double' - Двойная горизонтальная линия

Отображать ли текст в этом абзаце в виде индекса, задается как true или false. Настройка true отображает текст в виде индекса.

Отображать ли текст в этом абзаце в виде верхнего скрипта, задается как true или false. Настройка true визуализирует текст как суперскрипт.

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

ЗначениеОписание
'single'Одно подчеркивание
'double'Двойной подчеркивание
'heavy'Толстое подчеркивание
'words'Только подчеркнутые слова (не пространства)
'dotted'Пунктирное подчеркивание
'dottedheavy'Толстое, пунктирное подчеркивание
'dash'Штриховое подчеркивание
'dashheavy'Толстое, штриховое подчеркивание
'dashlong'Длинное штриховое подчеркивание
'dashlongheavy'Толстое, длинное, штриховое подчеркивание
'dotdash'Подчеркивание точки-штриха
'dotdashheavy'Толстое, пунктирное подчеркивание
'dotdotdash'Подчеркивание через точку-штрих
'dotdotdashheavy'Толстый, точка-штрих подчеркивание
'wavy'Волнистое подчеркивание
'wavyheavy'Толстое волнистое подчеркивание
'wavydouble'Волнистый, двойной подчеркивание
'none'Нет подчеркивания

Горизонтальное выравнивание текста в этом абзаце, заданное как одно из следующих значений:

  • 'center' - С центром

  • 'left' - Слева обосновано

  • 'right' - Право обосновано

  • 'justified' - Левое обоснованное и правое обоснованное, равномерно разнесение слов

  • 'distributed' - Левое обоснованное и правое обоснованное, равномерно разнесенные буквы

  • 'thaiDistributed' - Обоснованный влево и обоснованный вправо тайский текст, разделяющий символы равномерно

  • 'justifiedLow' - Обоснование текста на арабском языке

Уровень отступа этого абзаца, заданный как целое число в области значений [1,9]. Значение 1 указывает абзац верхнего уровня без отступа.

Форматирование абзацев, заданное как массив ячеек объектов формата PPT.

Добавьте объекты формата путем конкатенации существующего значения Style свойство с массивом ячеек, содержащим добавляемые объекты формата. Для примера:

para = mlreportgen.ppt.Paragraph('my paragraph');
para.Style = [para.Style {Bold(true),FontColor('red')}];

Смотрите Подходы к форматированию презентаций.

Дочерние элементы этого объекта, заданные как массив ячеек объектов PPT. Это свойство доступно только для чтения.

Родительский элемент этого объекта, заданный как объект PPT. Это свойство доступно только для чтения.

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

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

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

Методы

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

Примеры

свернуть все

Создайте презентацию с двумя слайдами.

import mlreportgen.ppt.*;

ppt = Presentation('myParagraphPresentation.pptx');
open(ppt);

add(ppt,'Title Slide');
add(ppt,'Title and Content');

Создайте mlreportgen.ppt.Paragraph объект, используемый для заголовка. Выделите текст полужирным и красным цветом.

p = Paragraph('My Title');
p.Bold = true;
p.FontColor = 'red';

Заменить заголовок первого слайда на абзац.

contents = find(ppt,'Title');
replace(contents(1),p);

Создать абзац для содержимого второго слайда.

p1 = Paragraph('My slide content');
append(p1,' for the second slide');

Замените содержимое на p1 абзац.

replace(ppt,'Content',p1);

Закройте и просмотрите презентацию.

close(ppt);
rptview(ppt);

Вот слайды в сгенерированной презентации:

Slide has a red and bold title. Slide has one bullet "My slide content for the second slide

Введенный в R2015b