mlreportgen.ppt.ContentPlaceholder class

Пакет: mlreportgen.ppt

Заполнитель для содержимого слайда

Описание

Объект mlreportgen.ppt.ContentPlaceholder класс представляет заполнитель содержимого на слайде. Заполнитель содержимого можно заменить изображением, таблицей или одним или несколькими абзацами.

PPT API создает ContentPlaceholder объект, когда вы добавляете слайд к презентации, и размещение слайда имеет заполнитель содержимого. В API PPT по умолчанию эти размещения имеют один или несколько заполнителей содержимого:

  • 'Title and Content'

  • 'Two Content'

  • 'Comparison'

  • 'Content with Caption'

Как найти ContentPlaceholder объект, используйте find метод слайда, содержащий заполнитель содержимого. Чтобы заменить заполнитель содержимого изображением, таблицей или одним или несколькими абзацами, используйте replace метод ContentPlaceholder объект. Для изображения или таблицы, replace метод заменяет ContentPlaceholder объект со mlreportgen.ppt.Picture или mlreportgen.ppt.Table объект, соответственно. Для абзацев PPT API не заменяет ContentPlaceholder объект. Оно добавляет mlreportgen.ppt.Paragraph объекты как дочерние элементы ContentPlaceholder объект.

Когда вы заменяете ContentPlaceholder объект со Table или Picture объект, часть ContentPlaceholder свойства объекта не применяются к содержимому замены. Для получения дополнительной информации см. раздел « Свойства».

Примечание

Если вы заменяете заполнитель содержимого изображением, Microsoft® PowerPoint® корректирует размер заполнителя содержимого с учетом размера изображения. Если необходимо, чтобы положение заполнителя и размер были фиксированы на слайде, используйте слайд с заполнителем изображения. См. mlreportgen.ppt.PicturePlaceholder.

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

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

HandleCompatible
true
ConstructOnLoad
true

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

Свойства

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

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

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

Типы данных: 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.

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

import mlreportgen.ppt.*
ppt = Presentation("My Presentation");
slide = add(ppt,"Title and Content");
content = find(slide,"Content");
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 свойство объекта.

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

Методы

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

Примеры

свернуть все

Добавить четыре Title and Content слайды к презентации. Замените заполнитель содержимого первого слайда текстом, второго слайда таблицей, третьего слайда изображением и четвертого слайда многоуровневым списком.

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

import mlreportgen.ppt.*

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

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

Добавьте слайд с Title and Content размещение.

slide1 = add(ppt,"Title and Content");

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

titlePlaceholderObj1 = find(slide1,"Title");

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

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

replace(titlePlaceholderObj1,"Content Replaced with Paragraph");

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

contentPlaceholderObj1 = find(slide1,"Content");

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

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

replace(contentPlaceholderObj1,Paragraph("This is my paragaph"));

Добавьте второй слайд с Title and Content размещение.

slide2 = add(ppt,"Title and Content");

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

titlePlaceholderObj2 = find(slide2,"Title");
replace(titlePlaceholderObj2,"Content Replaced with Table for Order 2 Magic Square");

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

contentPlaceholderObj2 = find(slide2,"Content");
replace(contentPlaceholderObj2,Table(magic(2)));

Добавьте третий слайд с Title and Content размещение.

slide3 = add(ppt,"Title and Content");

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

titlePlaceholderObj3 = find(slide3,"Title");
replace(titlePlaceholderObj3,"Content Replaced with Picture of Peppers");

Замените заполнитель содержимого изображением.

contentPlaceholderObj3 = find(slide3,"Content");
replace(contentPlaceholderObj3,Picture("peppers.png"));

Добавьте четвертый слайд с Title and Content размещение.

slide4 = add(ppt,"Title and Content");

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

titlePlaceholderObj4 = find(slide4,"Title");
replace(titlePlaceholderObj4,"Content Replaced with a Multilevel List");

Создайте содержимое для многоуровневого списка. Можно представлять многоуровневый список как массив ячеек, содержащий один или несколько массивов ячеек, представляющих подсписки. Использование mlreportgen.ppt.Paragraph объект для форматирования элемента в списке.

greenTea = Paragraph("Green Tea");
greenTea.FontColor = "green";

multilevelContent = { ...
    "Coffee", ...
    "Tea", ...
    { ...
        "Black Tea", ...
        greenTea, ...
    }, ...
    "Milk", ...
    };

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

contentPlaceholderObj4 = find(slide4,"Content");
replace(contentPlaceholderObj4,multilevelContent);

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

close(ppt);
rptview(ppt);

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

Совет

  • Когда вы заменяете содержимое заполнителя в презентации и затем используете презентацию как шаблон для новой презентации, объект, который PPT API создает для содержимого в новой презентации, зависит от типа содержимого, как показано в таблице.

    Замена содержимогоКласс объекта в новой презентации
    картинаmlreportgen.ppt.TemplatePicture
    таблицаmlreportgen.ppt.TemplateTable
    параграф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