Exponenta Banner
exponenta event banner

класс mlreportgen.ppt.TextÂPlaceholder

Пакет: mlreportgen.ppt

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

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

Описание

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

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

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

HandleCompatible
true
ConstructOnLoad
true

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

Свойства

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

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

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

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

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

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

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

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

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

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

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

  • in - дюймы

  • mm - миллиметров

  • pc - пикас

  • 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 - пикас

  • pt - точки

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

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

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

  • in - дюймы

  • mm - миллиметров

  • pc - пикас

  • pt - точки

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

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

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

  • in - дюймы

  • mm - миллиметров

  • pc - пикас

  • pt - точки

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

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

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

  • in - дюймы

  • mm - миллиметров

  • pc - пикас

  • 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-объект. Это свойство доступно только для чтения.

Идентификатор для этого объекта 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'

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 объект.

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

Поддержка