mlreportgen.ppt.TextBoxPlaceholder class

Пакет: mlreportgen.ppt

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

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

Описание

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

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

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

HandleCompatible
true
ConstructOnLoad
true

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

Свойства

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

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

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

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

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

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

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

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

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

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

  • cm 'centimeters'

  • in 'inches'

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

  • pc — цицеро

  • pt 'points'

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

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

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

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

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

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

'top'

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

'bottom'

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

'middle'

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

'topCentered'

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

'bottomCentered'

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

'middleCentered'

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

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

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

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

  • cm 'centimeters'

  • in 'inches'

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

  • pc — цицеро

  • pt 'points'

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

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

  • cm 'centimeters'

  • in 'inches'

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

  • pc — цицеро

  • pt 'points'

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

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

  • cm 'centimeters'

  • in 'inches'

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

  • pc — цицеро

  • pt 'points'

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

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

  • cm 'centimeters'

  • in 'inches'

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

  • pc — цицеро

  • pt 'points'

Форматирование заполнителя текстового поля в виде массива ячеек объектов формата 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 в виде вектора символов или строкового скаляра. Уникальный идентификатор сеанса сгенерирован как часть создания объекта. Можно задать ID, чтобы заменить сгенерированный ID.

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

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

Методы

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

Примеры

свернуть все

Скрипт Open Live Script

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

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

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'

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);

Вот титульный слайд в сгенерированном представлении:

Скрипт Open Live Script

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

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

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)

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

Советы

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

  • Чтобы видеть объекты местозаполнителя, которые API PPT создает для объекта понижения, просмотрите 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

Документация MATLAB Report Generator

Поддержка

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