Метод Shapes.AddPlaceholder (PowerPoint)

Статья
04/07/2023

Восстанавливает ранее удаленный заполнитель на слайде. Возвращает объект Shape , представляющий восстановленный заполнитель.

Синтаксис

выражение. AddPlaceholder( _Type_, _Left_, _Top_, _Width_, _Height_ )

выражение: переменная, представляющая объект Shapes.

Параметры

Имя	Обязательный или необязательный	Тип данных	Описание
Тип	Обязательный	PpPlaceholderType	Тип заполнителя. Заполнители типа ppPlaceholderVerticalBody или ppPlaceholderVerticalTitle находятся только на слайдах типа макета ppLayoutVerticalText, ppLayoutClipArtAndVerticalText, ppLayoutVerticalTitleAndText или ppLayoutVerticalTitleAndText. Нельзя создавать слайды с любым из этих макетов из пользовательского интерфейса; Их необходимо создать программным способом с помощью метода Add или путем задания свойства Layout существующего слайда.
Left	Необязательный	Single	Позиция (в точках) верхнего левого угла заполнителя относительно левого верхнего угла документа.
Top	Необязательный	Single	Позиция (в точках) верхнего левого угла заполнителя относительно левого верхнего угла документа.
Width	Необязательно	Single	Ширина заполнителя в точках.
Height	Необязательно	Single	Высота заполнителя в пунктах.

Возвращаемое значение

Shape

Примечания

Если с слайда было удалено несколько заполнителей указанного типа, метод AddPlaceholder добавит их на слайд по одному, начиная с заполнителя с наименьшим исходным номером индекса.

Пример

Предположим, что второй слайд в активной презентации изначально имел заголовок в верхней части слайда, который был удален вручную или со следующей строкой кода.

ActivePresentation.Slides(2).Shapes.Placeholders(1).Delete

В этом примере удаленный заполнитель восстанавливается для двух слайдов.

Application.ActivePresentation.Slides(2) _
    .Shapes.AddPlaceholder ppPlaceholderTitle

См. также

Объект Shapes

Поддержка и обратная связь

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.