Placeholders Object

  • Article
PowerPoint Developer Reference

A collection of all the Shape objects that represent placeholders on the specified slide.

Remarks

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.

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.

Example

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.

Visual Basic for Applications 
  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"

See Also