powerpoint package

Klassen

PowerPoint.Application
PowerPoint.Presentation
PowerPoint.RequestContext	Das RequestContext-Objekt erleichtert Anforderungen an die PowerPoint-Anwendung. Da das Office-Add-In und die PowerPoint-Anwendung in zwei verschiedenen Prozessen ausgeführt werden, ist der Anforderungskontext erforderlich, um über das Add-In Zugriff auf das PowerPoint-Objektmodell zu erhalten.
PowerPoint.Slide	Stellt eine einzelne Folie einer Präsentation dar.
PowerPoint.SlideCollection	Stellt die Auflistung von Folien in der Präsentation dar.

Schnittstellen

PowerPoint.InsertSlideOptions	Stellt die verfügbaren Optionen beim Einfügen von Folien dar.
PowerPoint.Interfaces.BulletFormatData	Eine Schnittstelle, die die durch Aufrufen bulletFormat.toJSON()von zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.BulletFormatUpdateData	Eine Schnittstelle zum Aktualisieren von Daten für das BulletFormat-Objekt zur Verwendung in bulletFormat.set({ ... }).
PowerPoint.Interfaces.CollectionLoadOptions	Bietet Möglichkeiten zum Laden von Eigenschaften nur einer Teilmenge von Membern einer Auflistung.
PowerPoint.Interfaces.ParagraphFormatData	Eine Schnittstelle, die die durch Aufrufen paragraphFormat.toJSON()von zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.ParagraphFormatUpdateData	Eine Schnittstelle zum Aktualisieren von Daten für das ParagraphFormat-Objekt zur Verwendung in paragraphFormat.set({ ... }).
PowerPoint.Interfaces.PresentationData	Eine Schnittstelle, die die durch Aufrufen presentation.toJSON()von zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.PresentationLoadOptions
PowerPoint.Interfaces.ShapeCollectionData	Eine Schnittstelle, die die durch Aufrufen shapeCollection.toJSON()von zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.ShapeCollectionUpdateData	Eine Schnittstelle zum Aktualisieren von Daten im ShapeCollection-Objekt zur Verwendung in shapeCollection.set({ ... }).
PowerPoint.Interfaces.ShapeData	Eine Schnittstelle, die die durch Aufrufen shape.toJSON()von zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.ShapeFillData	Eine Schnittstelle, die die durch Aufrufen shapeFill.toJSON()von zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.ShapeFillUpdateData	Eine Schnittstelle zum Aktualisieren von Daten im ShapeFill-Objekt zur Verwendung in shapeFill.set({ ... }).
PowerPoint.Interfaces.ShapeFontData	Eine Schnittstelle, die die durch Aufrufen shapeFont.toJSON()von zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.ShapeFontUpdateData	Eine Schnittstelle zum Aktualisieren von Daten im ShapeFont-Objekt zur Verwendung in shapeFont.set({ ... }).
PowerPoint.Interfaces.ShapeLineFormatData	Eine Schnittstelle, die die durch Aufrufen shapeLineFormat.toJSON()von zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.ShapeLineFormatUpdateData	Eine Schnittstelle zum Aktualisieren von Daten für das ShapeLineFormat-Objekt zur Verwendung in shapeLineFormat.set({ ... }).
PowerPoint.Interfaces.ShapeScopedCollectionData	Eine Schnittstelle, die die durch Aufrufen shapeScopedCollection.toJSON()von zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.ShapeScopedCollectionUpdateData	Eine Schnittstelle zum Aktualisieren von Daten im ShapeScopedCollection-Objekt zur Verwendung in shapeScopedCollection.set({ ... }).
PowerPoint.Interfaces.ShapeUpdateData	Eine Schnittstelle zum Aktualisieren von Daten im Shape-Objekt zur Verwendung in shape.set({ ... }).
PowerPoint.Interfaces.SlideCollectionData	Eine Schnittstelle, die die durch Aufrufen slideCollection.toJSON()von zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.SlideCollectionLoadOptions	Stellt die Auflistung von Folien in der Präsentation dar.
PowerPoint.Interfaces.SlideCollectionUpdateData	Eine Schnittstelle zum Aktualisieren von Daten im SlideCollection-Objekt zur Verwendung in slideCollection.set({ ... }).
PowerPoint.Interfaces.SlideData	Eine Schnittstelle, die die durch Aufrufen slide.toJSON()von zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.SlideLayoutCollectionData	Eine Schnittstelle, die die durch Aufrufen slideLayoutCollection.toJSON()von zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.SlideLayoutCollectionUpdateData	Eine Schnittstelle zum Aktualisieren von Daten im SlideLayoutCollection-Objekt zur Verwendung in slideLayoutCollection.set({ ... }).
PowerPoint.Interfaces.SlideLayoutData	Eine Schnittstelle, die die durch Aufrufen slideLayout.toJSON()von zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.SlideLoadOptions	Stellt eine einzelne Folie einer Präsentation dar.
PowerPoint.Interfaces.SlideMasterCollectionData	Eine Schnittstelle, die die durch Aufrufen slideMasterCollection.toJSON()von zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.SlideMasterCollectionUpdateData	Eine Schnittstelle zum Aktualisieren von Daten im SlideMasterCollection-Objekt zur Verwendung in slideMasterCollection.set({ ... }).
PowerPoint.Interfaces.SlideMasterData	Eine Schnittstelle, die die durch Aufrufen slideMaster.toJSON()von zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.SlideScopedCollectionData	Eine Schnittstelle, die die durch Aufrufen slideScopedCollection.toJSON()von zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.SlideScopedCollectionLoadOptions	Stellt eine Auflistung von Folien in der Präsentation dar.
PowerPoint.Interfaces.SlideScopedCollectionUpdateData	Eine Schnittstelle zum Aktualisieren von Daten im SlideScopedCollection-Objekt zur Verwendung in slideScopedCollection.set({ ... }).
PowerPoint.Interfaces.TagCollectionData	Eine Schnittstelle, die die durch Aufrufen tagCollection.toJSON()von zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.TagCollectionUpdateData	Eine Schnittstelle zum Aktualisieren von Daten im TagCollection-Objekt zur Verwendung in tagCollection.set({ ... }).
PowerPoint.Interfaces.TagData	Eine Schnittstelle, die die durch Aufrufen tag.toJSON()von zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.TagUpdateData	Eine Schnittstelle zum Aktualisieren von Daten für das Tag-Objekt zur Verwendung in tag.set({ ... }).
PowerPoint.Interfaces.TextFrameData	Eine Schnittstelle, die die durch Aufrufen textFrame.toJSON()von zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.TextFrameUpdateData	Eine Schnittstelle zum Aktualisieren von Daten für das TextFrame-Objekt zur Verwendung in textFrame.set({ ... }).
PowerPoint.Interfaces.TextRangeData	Eine Schnittstelle, die die durch Aufrufen textRange.toJSON()von zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.TextRangeUpdateData	Eine Schnittstelle zum Aktualisieren von Daten für das TextRange-Objekt zur Verwendung in textRange.set({ ... }).

Enumerationen

PowerPoint.ErrorCodes
PowerPoint.InsertSlideFormatting	Gibt die Formatierungsoptionen für das Einfügen von Folien an.

Functions

PowerPoint.createPresentation(base64File)	Erstellt und öffnet eine neue Präsentation. Optional kann die Präsentation mit einer base64-codierten .pptx-Datei vorab aufgefüllt werden. [ API-Satz: PowerPointApi 1.1 ]
PowerPoint.run(batch)	Führt ein Batchskript aus, das Aktionen für das PowerPoint-Objektmodell unter Verwendung eines neuen RequestContext ausführt. Wenn die Zusage aufgelöst wird, werden alle nachverfolgten Objekte, die während der Ausführung automatisch zugeordnet wurden, freigegeben.
PowerPoint.run(object, batch)	Führt ein Batchskript aus, das Aktionen für das PowerPoint-Objektmodell unter Verwendung des RequestContext eines zuvor erstellten API-Objekts ausführt. Wenn die Zusage aufgelöst wird, werden alle nachverfolgten Objekte, die während der Ausführung automatisch zugeordnet wurden, freigegeben.
PowerPoint.run(objects, batch)	Führt ein Batchskript aus, das Aktionen für das PowerPoint-Objektmodell unter Verwendung des RequestContext der zuvor erstellten API-Objekte ausführt.

Details zur Funktion

PowerPoint.createPresentation(base64File)

Erstellt und öffnet eine neue Präsentation. Optional kann die Präsentation mit einer base64-codierten .pptx-Datei vorab aufgefüllt werden.

[ API-Satz: PowerPointApi 1.1 ]

export function createPresentation(base64File?: string): Promise<void>;

Parameter

base64File

string

Optional. Die base64-codierte .pptx Datei. Der Standardwert ist null.

Gibt zurück

Promise<void>

Beispiele

const myFile = <HTMLInputElement>document.getElementById("file");
const reader = new FileReader();

reader.onload = (event) => {
  // Remove the metadata before the base64-encoded string.
  const startIndex = reader.result.toString().indexOf("base64,");
  const copyBase64 = reader.result.toString().substr(startIndex + 7);

  PowerPoint.createPresentation(copyBase64);
};

// Read in the file as a data URL so we can parse the base64-encoded string.
reader.readAsDataURL(myFile.files[0]);

PowerPoint.run(batch)

Führt ein Batchskript aus, das Aktionen für das PowerPoint-Objektmodell unter Verwendung eines neuen RequestContext ausführt. Wenn die Zusage aufgelöst wird, werden alle nachverfolgten Objekte, die während der Ausführung automatisch zugeordnet wurden, freigegeben.

export function run<T>(batch: (context: PowerPoint.RequestContext) => OfficeExtension.IPromise<T>): OfficeExtension.IPromise<T>;

Parameter

batch

(context: PowerPoint.RequestContext) => OfficeExtension.IPromise<T>

Eine Funktion, die einen RequestContext akzeptiert und eine Zusage zurückgibt (in der Regel nur das Ergebnis von "context.sync()"). Der Kontextparameter erleichtert Anforderungen an die PowerPoint-Anwendung. Da das Office-Add-In und die PowerPoint-Anwendung in zwei verschiedenen Prozessen ausgeführt werden, ist RequestContext erforderlich, um zugriff auf das PowerPoint-Objektmodell aus dem Add-In zu erhalten.

Gibt zurück

OfficeExtension.IPromise<T>

PowerPoint.run(object, batch)

Führt ein Batchskript aus, das Aktionen für das PowerPoint-Objektmodell unter Verwendung des RequestContext eines zuvor erstellten API-Objekts ausführt. Wenn die Zusage aufgelöst wird, werden alle nachverfolgten Objekte, die während der Ausführung automatisch zugeordnet wurden, freigegeben.

export function run<T>(object: OfficeExtension.ClientObject, batch: (context: PowerPoint.RequestContext) => OfficeExtension.IPromise<T>): OfficeExtension.IPromise<T>;

Parameter

object

OfficeExtension.ClientObject

Ein zuvor erstelltes API-Objekt. Der Batch verwendet denselben RequestContext wie das übergebene Objekt, was bedeutet, dass alle änderungen, die auf das Objekt angewendet werden, von "context.sync()" übernommen werden.

batch

(context: PowerPoint.RequestContext) => OfficeExtension.IPromise<T>

Eine Funktion, die einen RequestContext akzeptiert und eine Zusage zurückgibt (in der Regel nur das Ergebnis von "context.sync()"). Der Kontextparameter erleichtert Anforderungen an die PowerPoint-Anwendung. Da das Office-Add-In und die PowerPoint-Anwendung in zwei verschiedenen Prozessen ausgeführt werden, ist RequestContext erforderlich, um zugriff auf das PowerPoint-Objektmodell aus dem Add-In zu erhalten.

Gibt zurück

OfficeExtension.IPromise<T>

PowerPoint.run(objects, batch)

Führt ein Batchskript aus, das Aktionen für das PowerPoint-Objektmodell unter Verwendung des RequestContext der zuvor erstellten API-Objekte ausführt.

export function run<T>(objects: OfficeExtension.ClientObject[], batch: (context: PowerPoint.RequestContext) => OfficeExtension.IPromise<T>): OfficeExtension.IPromise<T>;

Parameter

objects

OfficeExtension.ClientObject[]

Ein Array von zuvor erstellten API-Objekten. Das Array wird überprüft, um sicherzustellen, dass alle Objekte denselben Kontext verwenden. Der Batch verwendet diesen freigegebenen RequestContext, was bedeutet, dass alle Änderungen, die auf diese Objekte angewendet werden, von "context.sync()" übernommen werden.

batch

(context: PowerPoint.RequestContext) => OfficeExtension.IPromise<T>

Eine Funktion, die einen RequestContext akzeptiert und eine Zusage zurückgibt (in der Regel nur das Ergebnis von "context.sync()"). Der Kontextparameter erleichtert Anforderungen an die PowerPoint-Anwendung. Da das Office-Add-In und die PowerPoint-Anwendung in zwei verschiedenen Prozessen ausgeführt werden, ist RequestContext erforderlich, um zugriff auf das PowerPoint-Objektmodell aus dem Add-In zu erhalten.

Gibt zurück

OfficeExtension.IPromise<T>