mlreportgen.ppt.ContentPlaceholder class

Пакет: mlreportgen.ppt

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

Описание

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

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

  • 'Title and Content'

  • 'Two Content'

  • 'Comparison'

  • 'Content with Caption'

Найти ContentPlaceholder объект, используйте find метод понижения, которое содержит заполнителя содержимого. Чтобы заменить заполнителя содержимого на изображение, таблица или один или несколько абзацев, использует replace метод ContentPlaceholder объект. Для изображения или таблицы, replace метод заменяет ContentPlaceholder объект с mlreportgen.ppt.Picture или mlreportgen.ppt.Table объект, соответственно. Для абзацев API PPT не заменяет 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 использование обычный текст веса.

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

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

Семейство шрифтов для текста в виде вектора символов или строкового скаляра. Задайте шрифт, который появляется в списке шрифтов в 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.

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

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

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

Методы

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

Примеры

свернуть все

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

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

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

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

Советы

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

    Заменяющее содержимоеКласс объекта в новом представлении
    изображение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