PowerPoint.AddSlideOptions interface

包:: powerpoint

表示添加新幻灯片时的可用选项。

注解

使用方

PowerPoint.SlideCollection：添加

示例

// 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	指定插入新幻灯片时应从零开始的索引。如果未指定或指定索引超出界限，将在演示文稿末尾添加新幻灯片。
layoutId	指定要用于新幻灯片的幻灯片版式的 ID。如果未提供任何 `layoutId` 内容，但提供了 a `slideMasterId` ，则将使用指定幻灯片母版中第一个版式的 ID。如果未提供任何 `slideMasterId` 内容，但提供了， `layoutId` 则指定的布局需要可用于描述) 中 `slideMasterId` 指定的默认幻灯片母版 (。否则，将引发错误。
slideMasterId	指定要用于新幻灯片的幻灯片母版的 ID。如果未提供， `slideMasterId` 则将使用上一张幻灯片的幻灯片母版。如果没有上一张幻灯片，则将使用演示文稿的第一个幻灯片母版。

属性详细信息

index

注意

此 API 以预览状态提供给开发者，可能根据我们收到的反馈更改。请勿在生产环境中使用此 API。

指定插入新幻灯片时应从零开始的索引。如果未指定或指定索引超出界限，将在演示文稿末尾添加新幻灯片。

index?: number;

属性值

number

注解

API 集：PowerPointApi BETA (仅预览版)

layoutId

指定要用于新幻灯片的幻灯片版式的 ID。如果未提供任何 layoutId 内容，但提供了 a slideMasterId ，则将使用指定幻灯片母版中第一个版式的 ID。如果未提供任何 slideMasterId 内容，但提供了， layoutId 则指定的布局需要可用于描述) 中 slideMasterId 指定的默认幻灯片母版 (。否则，将引发错误。

layoutId?: string;

属性值

string

注解

API 集：PowerPointApi 1.3

slideMasterId

指定要用于新幻灯片的幻灯片母版的 ID。如果未提供， slideMasterId 则将使用上一张幻灯片的幻灯片母版。如果没有上一张幻灯片，则将使用演示文稿的第一个幻灯片母版。

slideMasterId?: string;

属性值

string

注解

API 集：PowerPointApi 1.3

反馈

此页面是否有帮助？