mlreportgen.ppt.TextBoxPlaceholder class

Пакет: mlreportgen.ppt

Заполнитель для заголовка слайда

Описание

Объект mlreportgen.ppt.TextBoxPlaceholder класс является заполнителем для заголовка слайда. Когда вы добавляете слайд с заголовком к презентации, PPT API создает TextBoxPlaceholder объект для заголовка. Все размещения слайдов в стандартном PPT API, кроме Blank, иметь заголовок. Как найти TextBoxPlaceholder объект, используйте find метод слайда, содержащего заголовок. Затем можно задать свойства TextBoxPlaceholder Объект, чтобы задать формат по умолчанию для текста заголовка, который заменяет содержимое заполнителя. Чтобы заменить содержимое заполнителя текстом заголовка, используйте replace метод TextBoxPlaceholder объект. The replace метод не заменяет TextBoxPlaceholder объект. Он добавляет текст как один или несколько абзацев к Children свойство TextBoxPlaceholder объект.

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

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

HandleCompatible
true
ConstructOnLoad
true

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

Свойства

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

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

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

Семейство шрифтов для текста, заданное как вектор символов или строковый скаляр. Укажите шрифт, который отображается в списке шрифтов в 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 для курсива текста.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ЗначениеОписание

'top'

Вертикально выровненный по верхней части заполнителя текстового поля

'bottom'

Вертикально выровненный по нижней части заполнителя текстового поля

'middle'

Вертикально выровненный по середине заполнителя текстового поля

'topCentered'

Вертикально выровненный по верхней части и горизонтально выровненный по центру заполнителя текстового поля

'bottomCentered'

Вертикально выровненный по дну и горизонтально выровненный по центру заполнителя текстового поля

'middleCentered'

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

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

Верхний левый x - координата положения заполнителя текстового поля на слайде, заданная как вектор символов или строковый скаляр, который состоит из числа, за которым следует единица измерения. Для примера '5in' задает 5 дюймов. Допустимые сокращения:

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

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

  • in - дюймы

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

  • pc - picas

  • pt - точки

Верхний левый y - координата положения заполнителя текстового поля на слайде, заданная как вектор символов или строковый скаляр, который состоит из числа, за которым следует единица измерения. Для примера '5in' задает 5 дюймов. Допустимые сокращения:

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

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

  • in - дюймы

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

  • pc - picas

  • pt - точки

Ширина заполнителя текстового поля, заданная как вектор символов или строковый скаляр, который состоит из числа, за которым следует сокращение для единицы измерения. Для примера '5in' задает пять дюймов. Допустимые сокращения:

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

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

  • in - дюймы

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

  • pc - picas

  • pt - точки

Высота заполнителя текстового поля, заданная как вектор символов или строковый скаляр, который состоит из числа, за которым следует сокращение для единицы измерения. Для примера '5in' задает пять дюймов. Допустимые сокращения:

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

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

  • in - дюймы

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

  • pc - picas

  • pt - точки

Форматирование заполнителя текстового поля, заданное как массив ячеек объектов формата PPT. Форматы, которые не применяются к TextBoxPlaceholder объект игнорируется.

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

import mlreportgen.ppt.*
slide = add(ppt,"Title Slide");
content = find(slide,"Title");
placeholderObj = content(1);
placeholderObj.Style = [placeholderObj.Style {Bold(true),FontColor("red")}];
replace(placeholderObj,'Test');

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

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

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

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

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

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

Методы

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

Примеры

свернуть все

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

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

import mlreportgen.ppt.*

Создайте презентацию.

ppt = Presentation("myTextBoxPlaceholderPresentation.pptx");
open(ppt);

Добавьте слайд заголовка.

slide = add(ppt,"Title Slide");

Используйте find метод объекта слайда для поиска объекта-заполнителя с именем Title.

titlePlaceholderObj = find(slide,"Title")
titlePlaceholderObj = 
  TextBoxPlaceholder with properties:

                 Bold: []
                 Font: []
    ComplexScriptFont: []
            FontColor: []
             FontSize: []
               Italic: []
               Strike: []
            Subscript: []
          Superscript: []
            Underline: []
      BackgroundColor: []
               VAlign: []
                 Name: 'Title'
                    X: '1524000emu'
                    Y: '1122363emu'
                Width: '9144000emu'
               Height: '2387600emu'
                Style: []
             Children: []
               Parent: [1×1 mlreportgen.ppt.Slide]
                  Tag: 'ppt.TextBoxPlaceholder:21:61'
                   Id: '21:61'

The find метод возвращает mlreportgen.ppt.TextBoxPlaceholder объект.

Замените содержимое заполнителя текстом заголовка.

replace(titlePlaceholderObj(1),"My Title");

Найдите объект заполнителя для субтитра.

subtitlePlaceholderObj = find(slide,"Subtitle")
subtitlePlaceholderObj = 
  TextBoxPlaceholder with properties:

                 Bold: []
                 Font: []
    ComplexScriptFont: []
            FontColor: []
             FontSize: []
               Italic: []
               Strike: []
            Subscript: []
          Superscript: []
            Underline: []
      BackgroundColor: []
               VAlign: []
                 Name: 'Subtitle'
                    X: '1524000emu'
                    Y: '3602038emu'
                Width: '9144000emu'
               Height: '1655762emu'
                Style: []
             Children: []
               Parent: [1×1 mlreportgen.ppt.Slide]
                  Tag: 'ppt.TextBoxPlaceholder:22:62'
                   Id: '22:62'

Заполнитель объекта для субтитра также является mlreportgen.ppt.TextBoxPlaceholder объект.

Замените содержимое заполнителя текстом для субтитра.

replace(subtitlePlaceholderObj(1),"My Subtitle");

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

close(ppt);
rptview(ppt);

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

Чтобы добавить абзац к заголовку слайда, используйте add метод TextBoxPlaceholder объект, который представляет заголовок. Этот пример создает презентацию с Title and Table слайд, а затем создает вторую презентацию из первой презентации. Во второй презентации пример добавляет содержимое в заголовок Title and Table слайд.

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

import mlreportgen.ppt.*

Создайте презентацию и добавьте Title and Table слайд к презентации.

ppt = Presentation("myPPT1.pptx");
open(ppt);
slide = add(ppt,"Title and Table");

Найдите заполнитель текстового поля для заголовка и замените содержимое.

contents = find(slide,"Title");
replace(contents(1),"Hello World");

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

close(ppt);
rptview(ppt);

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

Создайте вторую презентацию, используя первую презентацию в качестве шаблона.

ppt = Presentation("myPPT2.pptx","myPPT1.pptx");
open(ppt);

Найдите заполнитель текстового поля для заголовка и добавьте содержимое к заголовку.

contents = find(ppt,"Title");
add(contents(1)," -- How are You?");

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

close(ppt);
rptview(ppt)

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

Совет

  • Если вы добавляете слайд с размещением, который имеет заполнитель для текста, не являющегося заголовком, PPT API создает mlreportgen.ppt.BodyPlaceholder или mlreportgen.ppt.ContentPlaceholder объект.

  • Чтобы увидеть объекты-заполнители, созданные PPT API для объекта слайда, просмотрите Children свойство слайда. Для примера, когда вы добавляете Title and Content слайд к презентации, Children свойство является массивом, который содержит mlreportgen.ppt.TextBoxPlaceholder объект и mlreportgen.ppt.ContentPlaceholder объект.

    ppt = mlreportgen.ppt.Presentation("test.pptx");
    open(ppt);
    slide = add(ppt,"Title and Content");
    slide.Children(1)
    
    ans = 
    
      TextBoxPlaceholder with properties:
    
                     Bold: []
                     Font: []
        ComplexScriptFont: []
                FontColor: []
                 FontSize: []
                   Italic: []
                   Strike: []
                Subscript: []
              Superscript: []
                Underline: []
          BackgroundColor: []
                   VAlign: []
                     Name: 'Title'
                        X: []
                        Y: []
                    Width: []
                   Height: []
                    Style: []
                 Children: []
                   Parent: [1×1 mlreportgen.ppt.Slide]
                      Tag: 'ppt.TextBoxPlaceholder:6:11'
                       Id: '6:11'

    slide.Children(2)
    
    ans = 
    
      ContentPlaceholder with properties:
    
                     Bold: []
                     Font: []
        ComplexScriptFont: []
                FontColor: []
                 FontSize: []
                   Italic: []
                   Strike: []
                Subscript: []
              Superscript: []
                Underline: []
          BackgroundColor: []
                   VAlign: []
                     Name: 'Content'
                        X: []
                        Y: []
                    Width: []
                   Height: []
                    Style: []
                 Children: []
                   Parent: [1×1 mlreportgen.ppt.Slide]
                      Tag: 'ppt.ContentPlaceholder:7:12'
                       Id: '7:12'
Введенный в R2015b