PowerPoint.InsertSlideOptions interface

Paket:
powerpoint

Stellt die verfügbaren Optionen beim Einfügen von Folien dar.

Hinweise

API-Satz: PowerPointApi 1.2

Verwendet von

Beispiele

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

Eigenschaften

formatting

Gibt an, welche Formatierung beim Einfügen der Folie verwendet werden soll. Die Standardoption ist die Verwendung von "KeepSourceFormatting".
sourceSlideIds

Gibt die Folien aus der Quellpräsentation an, die in die aktuelle Präsentation eingefügt werden. Diese Folien werden durch ihre IDs dargestellt, die von einem Slide Objekt abgerufen werden können. Die Reihenfolge dieser Folien wird beim Einfügen beibehalten. Wenn keine der Quellfolien gefunden wird oder die IDs ungültig sind, löst der Vorgang eine SlideNotFound Ausnahme aus, und es werden keine Folien eingefügt. Alle Quellfolien werden eingefügt, wenn sourceSlideIds diese nicht angegeben werden (dies ist das Standardverhalten).
targetSlideId

Gibt an, wo in der Präsentation die neuen Folien eingefügt werden. Die neuen Folien werden nach der Folie mit der angegebenen Folien-ID eingefügt. Wenn targetSlideId nicht angegeben, werden die Folien am Anfang der Präsentation eingefügt. Wenn targetSlideId diese ungültig ist oder auf eine nicht vorhandene Folie verweist, löst der Vorgang eine SlideNotFound Ausnahme aus, und es werden keine Folien eingefügt.

Details zur Eigenschaft

formatting

Gibt an, welche Formatierung beim Einfügen der Folie verwendet werden soll. Die Standardoption ist die Verwendung von "KeepSourceFormatting".

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

Eigenschaftswert

PowerPoint.InsertSlideFormatting | "KeepSourceFormatting" | "UseDestinationTheme"

Hinweise

API-Satz: PowerPointApi 1.2

sourceSlideIds

Gibt die Folien aus der Quellpräsentation an, die in die aktuelle Präsentation eingefügt werden. Diese Folien werden durch ihre IDs dargestellt, die von einem Slide Objekt abgerufen werden können. Die Reihenfolge dieser Folien wird beim Einfügen beibehalten. Wenn keine der Quellfolien gefunden wird oder die IDs ungültig sind, löst der Vorgang eine SlideNotFound Ausnahme aus, und es werden keine Folien eingefügt. Alle Quellfolien werden eingefügt, wenn sourceSlideIds diese nicht angegeben werden (dies ist das Standardverhalten).

sourceSlideIds?: string[];

Eigenschaftswert

string[]

Hinweise

API-Satz: PowerPointApi 1.2

targetSlideId

Gibt an, wo in der Präsentation die neuen Folien eingefügt werden. Die neuen Folien werden nach der Folie mit der angegebenen Folien-ID eingefügt. Wenn targetSlideId nicht angegeben, werden die Folien am Anfang der Präsentation eingefügt. Wenn targetSlideId diese ungültig ist oder auf eine nicht vorhandene Folie verweist, löst der Vorgang eine SlideNotFound Ausnahme aus, und es werden keine Folien eingefügt.

targetSlideId?: string;

Eigenschaftswert

string

Hinweise

API-Satz: PowerPointApi 1.2