Пакет: 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 |
Сведения об атрибутах класса см. в разделе Атрибуты класса.
При замене заполнителя в презентации, а затем использовании презентации в качестве шаблона для новой презентации, объект, который 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'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