PowerPoint.AddSlideOptions interface
Stellt die verfügbaren Optionen dar, wenn eine neue Folie hinzugefügt wird.
Hinweise
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. |
| layout |
Gibt die ID eines Folienlayouts an, das für die neue Folie verwendet werden soll. Wenn nein, |
| slide |
Gibt die ID eines Folienmasters an, die für die neue Folie verwendet werden soll. Wenn nein, |
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
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
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