Placeholders Collection Object
Shapes Placeholders Shape Multiple objects |
A collection of all the Shape objects that represent placeholders on the specified slide. Each Shape object in the Placeholders collection represents a placeholder for text, a chart, a table, an organizational chart, or some other type of object. If the slide has a title, the title is the first placeholder in the collection.
Using the Placeholders Collection
Use the Placeholders property to return the Placeholders collection. Use Placeholders(index), where index is the placeholder index number, to return a Shape object that represents a single placeholder. Note that for any slide that has a title, Shapes.Title
is equivalent to Shapes.Placeholders(1)
.The following example adds a new slide with a Bulleted List slide layout to the beginning of the presentation, sets the text for the title, and then adds two paragraphs to the text placeholder.
Set sObj = ActivePresentation.Slides.Add(1, ppLayoutText).Shapes
sObj.Title.TextFrame.TextRange.Text = "This is the title text"
sObj.Placeholders(2).TextFrame.TextRange.Text = _
"Item 1" & Chr(13) & "Item 2"
You can delete individual placeholders by using the Delete method, and you can restore deleted placeholders by using the AddPlaceholder method, but you cannot add any more placeholders to a slide than it had when it was created. To change the number of placeholders on a given slide, set the Layout property.
Properties | Application Property | Count Property | Parent Property
Methods | Item Method
Parent Objects | Shapes
Child Objects | ActionSettings | Adjustments | AnimationSettings | CalloutFormat | ConnectorFormat | Diagram | DiagramNode | FillFormat | GroupShapes | LineFormat | LinkFormat | OLEFormat | PictureFormat | PlaceholderFormat | ShadowFormat | Shape | ShapeNodes | Table | Tags | TextEffectFormat | TextFrame | ThreeDFormat