exponenta event banner

класс mlreportgen.ppt.ContentPlaceholder

Пакет: 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.

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

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

HandleCompatible
true
ConstructOnLoad
true

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

Свойства

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

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

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

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

Добавление объектов форматирования путем объединения существующего значения 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-объект. Это свойство доступно только для чтения.

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

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

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

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

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

contentPlaceholderObj1 = find(slide1,"Content");

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

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

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