Share via


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