PowerPoint.AddSlideOptions interface

Stellt die verfügbaren Optionen dar, wenn eine neue Folie hinzugefügt wird.

Hinweise

API-Satz: PowerPointApi 1.3

Verwendet von

Beispiele

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/powerpoint/slide-management/add-slides.yaml

const chosenMaster = (document.getElementById("master-id") as HTMLInputElement).value;
const chosenLayout = (document.getElementById("layout-id") as HTMLInputElement).value;

await PowerPoint.run(async function(context) {
  // Create a new slide using an existing master slide and layout.
  const newSlideOptions: PowerPoint.AddSlideOptions = {
    slideMasterId: chosenMaster, /* An ID from `Presentation.slideMasters`. */
    layoutId: chosenLayout /* An ID from `SlideMaster.layouts`. */
  };
  context.presentation.slides.add(newSlideOptions);
  await context.sync();
});

Eigenschaften

index

Gibt den 0-basierten Index an, bei dem die neue Folie eingefügt werden soll. Wenn nicht angegeben oder wenn der angegebene Index außerhalb des gültigen Bereichs liegt, wird die neue Folie am Ende der Präsentation hinzugefügt.

layoutId

Gibt die ID eines Folienlayouts an, das für die neue Folie verwendet werden soll. Wenn nein, layoutId aber a slideMasterId angegeben wird, wird die ID des ersten Layouts aus dem angegebenen Folienmaster verwendet. Wenn nein, slideMasterId aber a layoutId angegeben wird, muss das angegebene Layout für den Standardfolienmaster verfügbar sein (wie in der slideMasterId Beschreibung angegeben). Andernfalls wird ein Fehler ausgelöst.

slideMasterId

Gibt die ID eines Folienmasters an, die für die neue Folie verwendet werden soll. Wenn nein, slideMasterId wird der Folienmaster der vorherigen Folie verwendet. Wenn keine vorherige Folie vorhanden ist, wird der erste Folienmaster der Präsentation verwendet.

Details zur Eigenschaft

index

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 den 0-basierten Index an, bei dem die neue Folie eingefügt werden soll. Wenn nicht angegeben oder wenn der angegebene Index außerhalb des gültigen Bereichs liegt, wird die neue Folie am Ende der Präsentation hinzugefügt.

index?: number;

Eigenschaftswert

number

Hinweise

API-Satz: PowerPointApi BETA (NUR VORSCHAU)

layoutId

Gibt die ID eines Folienlayouts an, das für die neue Folie verwendet werden soll. Wenn nein, layoutId aber a slideMasterId angegeben wird, wird die ID des ersten Layouts aus dem angegebenen Folienmaster verwendet. Wenn nein, slideMasterId aber a layoutId angegeben wird, muss das angegebene Layout für den Standardfolienmaster verfügbar sein (wie in der slideMasterId Beschreibung angegeben). Andernfalls wird ein Fehler ausgelöst.

layoutId?: string;

Eigenschaftswert

string

Hinweise

API-Satz: PowerPointApi 1.3

slideMasterId

Gibt die ID eines Folienmasters an, die für die neue Folie verwendet werden soll. Wenn nein, slideMasterId wird der Folienmaster der vorherigen Folie verwendet. Wenn keine vorherige Folie vorhanden ist, wird der erste Folienmaster der Präsentation verwendet.

slideMasterId?: string;

Eigenschaftswert

string

Hinweise

API-Satz: PowerPointApi 1.3