PowerPoint.InsertSlideOptions interface

Package:

powerpoint

Represents the available options when inserting slides.

Remarks

API set: PowerPointApi 1.2

Used by

• PowerPoint.Presentation: insertSlidesFromBase64

Examples

// 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();
});

Properties

formatting	Specifies which formatting to use during slide insertion. The default option is to use "KeepSourceFormatting".
sourceSlideIds	Specifies the slides from the source presentation that will be inserted into the current presentation. These slides are represented by their IDs which can be retrieved from a Slide object. The order of these slides is preserved during the insertion. If any of the source slides aren't found, or if the IDs are invalid, the operation throws a SlideNotFound exception and no slides will be inserted. All of the source slides will be inserted when sourceSlideIds isn't provided (this is the default behavior).
targetSlideId	Specifies where in the presentation the new slides will be inserted. The new slides will be inserted after the slide with the given slide ID. If targetSlideId isn't provided, the slides will be inserted at the beginning of the presentation. If targetSlideId is invalid or if it's pointing to a non-existing slide, the operation throws a SlideNotFound exception and no slides will be inserted.

Property Details

formatting

Specifies which formatting to use during slide insertion. The default option is to use "KeepSourceFormatting".

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

Property Value

PowerPoint.InsertSlideFormatting | "KeepSourceFormatting" | "UseDestinationTheme"

Remarks

API set: PowerPointApi 1.2

sourceSlideIds

Specifies the slides from the source presentation that will be inserted into the current presentation. These slides are represented by their IDs which can be retrieved from a Slide object. The order of these slides is preserved during the insertion. If any of the source slides aren't found, or if the IDs are invalid, the operation throws a SlideNotFound exception and no slides will be inserted. All of the source slides will be inserted when sourceSlideIds isn't provided (this is the default behavior).

sourceSlideIds?: string[];

Property Value

string[]

Remarks

API set: PowerPointApi 1.2

targetSlideId

Specifies where in the presentation the new slides will be inserted. The new slides will be inserted after the slide with the given slide ID. If targetSlideId isn't provided, the slides will be inserted at the beginning of the presentation. If targetSlideId is invalid or if it's pointing to a non-existing slide, the operation throws a SlideNotFound exception and no slides will be inserted.

targetSlideId?: string;

Property Value

string

Remarks

API set: PowerPointApi 1.2