PowerPoint.AddSlideOptions interface

Пакет:

powerpoint

Представляет доступные параметры при добавлении нового слайда.

Комментарии

[ Набор API: PowerPointApi 1.3 ]

Примеры

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/powerpoint/slide-management/add-slides.yaml

const chosenMaster = (document.getElementById("master-id") as HTMLInputElement).value;
const chosenLayout = (document.getElementById("layout-id") as HTMLInputElement).value;

await PowerPoint.run(async function(context) {
  // Create a new slide using an existing master slide and layout.
  const newSlideOptions: PowerPoint.AddSlideOptions = {
    slideMasterId: chosenMaster, /* An ID from `Presentation.slideMasters`. */
    layoutId: chosenLayout /* An ID from `SlideMaster.layouts`. */
  };
  context.presentation.slides.add(newSlideOptions);
  await context.sync();
});

Свойства

index	Указывает индекс на основе 0, по которому должен быть вставлен новый слайд. Если значение не указано или если указанный индекс выходит за пределы, новый слайд будет добавлен в конце презентации.
layoutId	Указывает идентификатор макета слайда, который будет использоваться для нового слайда. Если не layoutId указано, но задано значение , slideMasterId будет использоваться идентификатор первого макета из указанного образца слайдов. Если нет slideMasterId , но задано значение , layoutId то указанный макет должен быть доступен для образца слайдов по умолчанию (как указано в описании slideMasterId ). В противном случае будет выдана ошибка.
slideMasterId	Указывает идентификатор образца слайдов, который будет использоваться для нового слайда. Если параметр не slideMasterId указан, будет использоваться образец слайдов предыдущего слайда. Если предыдущий слайд отсутствует, будет использоваться первый образец слайдов презентации.

Сведения о свойстве

index

Примечание

Этот API предоставляется в качестве предварительной версии для разработчиков и может быть изменен на основе полученных нами отзывов. Не используйте этот API в рабочей среде.

Указывает индекс на основе 0, по которому должен быть вставлен новый слайд. Если значение не указано или если указанный индекс выходит за пределы, новый слайд будет добавлен в конце презентации.

index?: number;

Значение свойства

number

Комментарии

[ Набор API: PowerPointApi BETA (ТОЛЬКО ПРЕДВАРИТЕЛЬНАЯ ВЕРСИЯ) ]

layoutId

Указывает идентификатор макета слайда, который будет использоваться для нового слайда. Если не layoutId указано, но задано значение , slideMasterId будет использоваться идентификатор первого макета из указанного образца слайдов. Если нет slideMasterId , но задано значение , layoutId то указанный макет должен быть доступен для образца слайдов по умолчанию (как указано в описании slideMasterId ). В противном случае будет выдана ошибка.

layoutId?: string;

Значение свойства

string

Комментарии

[ Набор API: PowerPointApi 1.3 ]

slideMasterId

Указывает идентификатор образца слайдов, который будет использоваться для нового слайда. Если параметр не slideMasterId указан, будет использоваться образец слайдов предыдущего слайда. Если предыдущий слайд отсутствует, будет использоваться первый образец слайдов презентации.

slideMasterId?: string;

Значение свойства

string

Комментарии

[ Набор API: PowerPointApi 1.3 ]