Freigeben über


PowerPoint.AddSlideOptions interface

Stellt die verfügbaren Optionen beim Hinzufügen einer neuen Folie dar.

Hinweise

[ API-Satz: PowerPointApi 1.3 ]

Beispiele

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

const chosenMaster = $("#master-id").val() as string;
const chosenLayout = $("#layout-id").val() as string;

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 kein layoutId angegeben, aber ein slideMasterId angegeben wird, wird die ID des ersten Layouts aus dem angegebenen Folienmaster verwendet. Wenn kein slideMasterId angegeben, aber ein layoutId bereitgestellt 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, der für die neue Folie verwendet werden soll. Wenn kein slideMasterId angegeben ist, 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 kein layoutId angegeben, aber ein slideMasterId angegeben wird, wird die ID des ersten Layouts aus dem angegebenen Folienmaster verwendet. Wenn kein slideMasterId angegeben, aber ein layoutId bereitgestellt 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, der für die neue Folie verwendet werden soll. Wenn kein slideMasterId angegeben ist, 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 ]