PowerPoint.InsertSlideOptions interface

表示插入幻灯片时可用的选项。

注解

[ API 集:PowerPointApi 1.2 ]

示例

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

await PowerPoint.run(async function(context) {
    // Get the ID of the first selected slide.
    const presentation: PowerPoint.Presentation = context.presentation;
    const selected: PowerPoint.Slide = presentation.getSelectedSlides().getItemAt(0);
    selected.load("id");
    await context.sync();

    // Insert the other presentation after the selected slide.
    const insertOptions: PowerPoint.InsertSlideOptions = {
        formatting: PowerPoint.InsertSlideFormatting.useDestinationTheme,
        targetSlideId: selected.id
    };
    presentation.insertSlidesFromBase64(chosenFileBase64, insertOptions);
    await context.sync();
});

属性

formatting

指定在幻灯片插入期间要使用的格式。 默认选项是使用“KeepSourceFormatting”。

sourceSlideIds

指定要插入当前演示文稿的源演示文稿中的幻灯片。 这些幻灯片由可从 对象检索 Slide 的 ID 表示。 插入期间会保留这些幻灯片的顺序。 如果未找到任何源幻灯片,或者 ID 无效,则操作将 SlideNotFound 引发异常,并且不会插入任何幻灯片。 如果未提供 ,则将插入 sourceSlideIds 所有源幻灯片, (这是) 的默认行为。

targetSlideId

指定在演示文稿中插入新幻灯片的位置。 新幻灯片将插入到具有给定幻灯片 ID 的幻灯片之后。 如果未 targetSlideId 提供 ,幻灯片将插入演示文稿的开头。 如果 targetSlideId 无效或指向不存在的幻灯片,则操作将 SlideNotFound 引发异常,并且不会插入任何幻灯片。

属性详细信息

formatting

指定在幻灯片插入期间要使用的格式。 默认选项是使用“KeepSourceFormatting”。

formatting?: PowerPoint.InsertSlideFormatting | "KeepSourceFormatting" | "UseDestinationTheme";

属性值

PowerPoint.InsertSlideFormatting | "KeepSourceFormatting" | "UseDestinationTheme"

注解

[ API 集:PowerPointApi 1.2 ]

sourceSlideIds

指定要插入当前演示文稿的源演示文稿中的幻灯片。 这些幻灯片由可从 对象检索 Slide 的 ID 表示。 插入期间会保留这些幻灯片的顺序。 如果未找到任何源幻灯片,或者 ID 无效,则操作将 SlideNotFound 引发异常,并且不会插入任何幻灯片。 如果未提供 ,则将插入 sourceSlideIds 所有源幻灯片, (这是) 的默认行为。

sourceSlideIds?: string[];

属性值

string[]

注解

[ API 集:PowerPointApi 1.2 ]

targetSlideId

指定在演示文稿中插入新幻灯片的位置。 新幻灯片将插入到具有给定幻灯片 ID 的幻灯片之后。 如果未 targetSlideId 提供 ,幻灯片将插入演示文稿的开头。 如果 targetSlideId 无效或指向不存在的幻灯片,则操作将 SlideNotFound 引发异常,并且不会插入任何幻灯片。

targetSlideId?: string;

属性值

string

注解

[ API 集:PowerPointApi 1.2 ]