PowerPoint.InsertSlideOptions interface

  • Referenz
Paket:
powerpoint

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

Hinweise

[ API-Satz: PowerPointApi 1.2 ]

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 = context.presentation;
    const selected = 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 von Folien 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 aus einem Slide -Objekt abgerufen werden können. Die Reihenfolge dieser Folien wird während des Einfügens beibehalten. Wenn eine der Quellfolien nicht gefunden wird oder die IDs ungültig sind, löst der Vorgang eine Ausnahme aus SlideNotFound , und es werden keine Folien eingefügt. Alle Quellfolien werden eingefügt, wenn sourceSlideIds nicht angegeben wird (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 wird, werden die Folien am Anfang der Präsentation eingefügt. Wenn targetSlideId ungültig ist oder auf eine nicht vorhandene Folie verweist, löst der Vorgang eine Ausnahme aus SlideNotFound , und es werden keine Folien eingefügt.

Details zur Eigenschaft

formatting

Gibt an, welche Formatierung beim Einfügen von Folien 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 aus einem Slide -Objekt abgerufen werden können. Die Reihenfolge dieser Folien wird während des Einfügens beibehalten. Wenn eine der Quellfolien nicht gefunden wird oder die IDs ungültig sind, löst der Vorgang eine Ausnahme aus SlideNotFound , und es werden keine Folien eingefügt. Alle Quellfolien werden eingefügt, wenn sourceSlideIds nicht angegeben wird (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 wird, werden die Folien am Anfang der Präsentation eingefügt. Wenn targetSlideId ungültig ist oder auf eine nicht vorhandene Folie verweist, löst der Vorgang eine Ausnahme aus SlideNotFound , und es werden keine Folien eingefügt.

targetSlideId?: string;

Eigenschaftswert

string

Hinweise

[ API-Satz: PowerPointApi 1.2 ]