PowerPoint.Presentation class

Extends

Eigenschaften

context

Der Dem Objekt zugeordnete Anforderungskontext. Dadurch wird der Prozess des Add-Ins mit dem Prozess der Office-Hostanwendung verbunden.

slideMasters

Gibt die Auflistung der SlideMaster Objekte zurück, die sich in der Präsentation befinden.

[API-Satz: PowerPointApi BETA (NUR VORSCHAU)]

slides

Gibt eine geordnete Auflistung von Folien in der Präsentation zurück.

[API-Satz: PowerPointApi 1.2]

tags

Gibt eine Auflistung von Tags zurück, die der Präsentation zugeordnet sind.

[API-Satz: PowerPointApi BETA (NUR VORSCHAU)]

title

Methoden

insertSlidesFromBase64(base64File, options)

Fügt die angegebenen Folien aus einer Präsentation in die aktuelle Präsentation ein.

[API-Satz: PowerPointApi 1.2]

load(options)

Stellt einen Befehl zum Laden der angegebenen Eigenschaften des Objekts in die Warteschlange ein. Vor dem Lesen der Eigenschaften müssen Sie "context.sync()" aufrufen.

load(propertyNames)

Stellt einen Befehl zum Laden der angegebenen Eigenschaften des Objekts in die Warteschlange ein. Vor dem Lesen der Eigenschaften müssen Sie "context.sync()" aufrufen.

load(propertyNamesAndPaths)

Stellt einen Befehl zum Laden der angegebenen Eigenschaften des Objekts in die Warteschlange ein. Vor dem Lesen der Eigenschaften müssen Sie "context.sync()" aufrufen.

toJSON()

Überschreibt die JavaScript-Methode, um eine nützlichere Ausgabe zu toJSON() bieten, wenn ein API-Objekt an übergeben wird JSON.stringify(). (JSON.stringifyruft wiederum die Methode toJSON des Objekts auf, das an das Objekt übergeben wird.) Während das ursprüngliche PowerPoint.Presentation-Objekt ein API-Objekt ist, gibt die Methode ein toJSON einfaches JavaScript-Objekt zurück (Typ: PowerPoint.Interfaces.PresentationData), die flache Kopien aller geladenen untergeordneten Eigenschaften aus dem ursprünglichen Objekt enthält.

Details zur Eigenschaft

context

Der Dem Objekt zugeordnete Anforderungskontext. Dadurch wird der Prozess des Add-Ins mit dem Prozess der Office-Hostanwendung verbunden.

context: RequestContext;

Eigenschaftswert

slideMasters

Hinweis

Diese API wird als Vorschau für Entwickler bereitgestellt. Je nachdem, welches Feedback wir dazu erhalten, werden möglicherweise Änderungen vorgenommen. Verwenden Sie diese API nicht in einer Produktionsumgebung.

Gibt die Auflistung der SlideMaster Objekte zurück, die sich in der Präsentation befinden.

[API-Satz: PowerPointApi BETA (NUR VORSCHAU)]

readonly slideMasters: PowerPoint.SlideMasterCollection;

Eigenschaftswert

slides

Gibt eine geordnete Auflistung von Folien in der Präsentation zurück.

[API-Satz: PowerPointApi 1.2]

readonly slides: PowerPoint.SlideCollection;

Eigenschaftswert

tags

Hinweis

Diese API wird als Vorschau für Entwickler bereitgestellt. Je nachdem, welches Feedback wir dazu erhalten, werden möglicherweise Änderungen vorgenommen. Verwenden Sie diese API nicht in einer Produktionsumgebung.

Gibt eine Auflistung von Tags zurück, die der Präsentation zugeordnet sind.

[API-Satz: PowerPointApi BETA (NUR VORSCHAU)]

readonly tags: PowerPoint.TagCollection;

Eigenschaftswert

title

readonly title: string;

Eigenschaftswert

string

Details zur Methode

insertSlidesFromBase64(base64File, options)

Fügt die angegebenen Folien aus einer Präsentation in die aktuelle Präsentation ein.

[API-Satz: PowerPointApi 1.2]

insertSlidesFromBase64(base64File: string, options?: PowerPoint.InsertSlideOptions): void;

Parameter

base64File

string

Die base64-codierte Zeichenfolge, die die Quellpräsentationsdatei darstellt.

options
PowerPoint.InsertSlideOptions

Die Optionen, mit denen definiert wird, welche Folien eingefügt werden, wo die neuen Folien angezeigt werden und welche Formatierung der Präsentation verwendet wird.

Gibt zurück

void

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) {
    const selectedSlideID = await getSelectedSlideID();

    context.presentation.insertSlidesFromBase64(chosenFileBase64, {
        formatting: PowerPoint.InsertSlideFormatting.useDestinationTheme,
        targetSlideId: selectedSlideID + "#"
    });
    await context.sync();
});

load(options)

Stellt einen Befehl zum Laden der angegebenen Eigenschaften des Objekts in die Warteschlange ein. Vor dem Lesen der Eigenschaften müssen Sie "context.sync()" aufrufen.

load(options?: PowerPoint.Interfaces.PresentationLoadOptions): PowerPoint.Presentation;

Parameter

options
PowerPoint.Interfaces.PresentationLoadOptions

Stellt Optionen für die Eigenschaften des zu ladenden Objekts zur Verfügung.

Gibt zurück

load(propertyNames)

Stellt einen Befehl zum Laden der angegebenen Eigenschaften des Objekts in die Warteschlange ein. Vor dem Lesen der Eigenschaften müssen Sie "context.sync()" aufrufen.

load(propertyNames?: string | string[]): PowerPoint.Presentation;

Parameter

propertyNames

string | string[]

Eine durch Trennzeichen getrennte Zeichenfolge oder ein Array von Zeichenfolgen, die die zu ladenden Eigenschaften angeben.

Gibt zurück

load(propertyNamesAndPaths)

Stellt einen Befehl zum Laden der angegebenen Eigenschaften des Objekts in die Warteschlange ein. Vor dem Lesen der Eigenschaften müssen Sie "context.sync()" aufrufen.

load(propertyNamesAndPaths?: {
            select?: string;
            expand?: string;
        }): PowerPoint.Presentation;

Parameter

propertyNamesAndPaths

{ select?: string; expand?: string; }

propertyNamesAndPaths.select ist eine durch Trennzeichen getrennte Zeichenfolge, die die zu ladenden Eigenschaften angibt, und eine durch Kommas getrennte Zeichenfolge, die die zu ladenden propertyNamesAndPaths.expand Navigationseigenschaften angibt.

Gibt zurück

toJSON()

Überschreibt die JavaScript-Methode, um eine nützlichere Ausgabe zu toJSON() bieten, wenn ein API-Objekt an übergeben wird JSON.stringify(). (JSON.stringifyruft wiederum die Methode toJSON des Objekts auf, das an das Objekt übergeben wird.) Während das ursprüngliche PowerPoint.Presentation-Objekt ein API-Objekt ist, gibt die Methode ein toJSON einfaches JavaScript-Objekt zurück (Typ: PowerPoint.Interfaces.PresentationData), die flache Kopien aller geladenen untergeordneten Eigenschaften aus dem ursprünglichen Objekt enthält.

toJSON(): PowerPoint.Interfaces.PresentationData;

Gibt zurück