PowerPoint.Slide class

Stellt eine einzelne Folie einer Präsentation dar.

[API-Satz: PowerPointApi 1.2]

Extends

Eigenschaften

context

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

id

Ruft die eindeutige ID der Folie ab.

[API-Satz: PowerPointApi 1.2]

layout

Ruft das Layout der Folie ab.

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

shapes

Gibt eine Auflistung von Formen auf der Folie zurück.

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

slideMaster

Ruft das SlideMaster Objekt ab, das den Standardinhalt der Folie darstellt.

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

tags

Gibt eine Auflistung von Tags auf der Folie zurück.

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

Methoden

delete()

Löscht die Folie aus der Präsentation. Führt nichts aus, wenn die Folie nicht vorhanden ist.

[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.Slide-Objekt ein API-Objekt ist, gibt die Methode ein toJSON einfaches JavaScript-Objekt zurück (Typ: PowerPoint.Interfaces.SlideData), 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

id

Ruft die eindeutige ID der Folie ab.

[API-Satz: PowerPointApi 1.2]

readonly id: string;

Eigenschaftswert

string

layout

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.

Ruft das Layout der Folie ab.

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

readonly layout: PowerPoint.SlideLayout;

Eigenschaftswert

shapes

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 Formen auf der Folie zurück.

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

readonly shapes: PowerPoint.ShapeCollection;

Eigenschaftswert

slideMaster

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.

Ruft das SlideMaster Objekt ab, das den Standardinhalt der Folie darstellt.

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

readonly slideMaster: PowerPoint.SlideMaster;

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 auf der Folie zurück.

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

readonly tags: PowerPoint.TagCollection;

Eigenschaftswert

Details zur Methode

delete()

Löscht die Folie aus der Präsentation. Führt nichts aus, wenn die Folie nicht vorhanden ist.

[API-Satz: PowerPointApi 1.2]

delete(): void;

Gibt zurück

void

Beispiele

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/powerpoint/preview-apis/tags.yaml
await PowerPoint.run(async function(context) {
  const slides = context.presentation.slides;
  slides.load("tags/key, tags/value");

  await context.sync();

  for (let i = 0; i < slides.items.length; i++) {
    let currentSlide = slides.items[i];
    for (let j = 0; j < currentSlide.tags.items.length; j++) {
      let currentTag = currentSlide.tags.items[j];
      if (currentTag.key === "CUSTOMER_TYPE" && currentTag.value === "Premium") {
        currentSlide.delete();
      }
    }
  }

  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.SlideLoadOptions): PowerPoint.Slide;

Parameter

options
PowerPoint.Interfaces.SlideLoadOptions

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.Slide;

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.Slide;

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.Slide-Objekt ein API-Objekt ist, gibt die Methode ein toJSON einfaches JavaScript-Objekt zurück (Typ: PowerPoint.Interfaces.SlideData), die flache Kopien aller geladenen untergeordneten Eigenschaften aus dem ursprünglichen Objekt enthält.

toJSON(): PowerPoint.Interfaces.SlideData;

Gibt zurück