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

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

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