Пакет: 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 |
Для получения информации об атрибутах класса см. раздел «Атрибуты класса».
Когда вы заменяете содержимое заполнителя в презентации и затем используете презентацию как шаблон для новой презентации, объект, который 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'
getLayoutNames
| mlreportgen.ppt.Paragraph
| mlreportgen.ppt.Picture
| mlreportgen.ppt.PicturePlaceholder
| mlreportgen.ppt.Table
| mlreportgen.ppt.TablePlaceholder
| mlreportgen.ppt.TemplatePicture
| mlreportgen.ppt.TemplateTable
| mlreportgen.ppt.TextBoxPlaceholder