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.Shape	Stellt eine einzelne Form auf der Folie dar.
PowerPoint.ShapeCollection	Stellt die Auflistung von Shapes dar.
PowerPoint.Slide	Stellt eine einzelne Folie einer Präsentation dar.
PowerPoint.SlideCollection	Stellt die Auflistung von Folien in der Präsentation dar.
PowerPoint.SlideLayout	Stellt das Layout einer Folie dar.
PowerPoint.SlideLayoutCollection	Stellt die Auflistung von Layouts dar, die vom Folienmaster für Folien bereitgestellt werden.
PowerPoint.SlideMaster	Stellt den Folienmaster einer Folie dar.
PowerPoint.SlideMasterCollection	Stellt die Auflistung der Folienmaster in der Präsentation dar.
PowerPoint.Tag	Stellt ein einzelnes Tag auf der Folie dar.
PowerPoint.TagCollection	Stellt die Auflistung von Tags dar.

Schnittstellen

PowerPoint.AddSlideOptions	Stellt die verfügbaren Optionen beim Hinzufügen einer neuen Folie dar.
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.HyperlinkCollectionData	Eine Schnittstelle, die die durch Aufrufen hyperlinkCollection.toJSON()von zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.HyperlinkCollectionUpdateData	Eine Schnittstelle zum Aktualisieren von Daten für das HyperlinkCollection -Objekt zur Verwendung in hyperlinkCollection.set({ ... }).
PowerPoint.Interfaces.HyperlinkData	Eine Schnittstelle, die die durch Aufrufen hyperlink.toJSON()von zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.HyperlinkUpdateData	Eine Schnittstelle zum Aktualisieren von Daten für das Hyperlink -Objekt zur Verwendung in hyperlink.set({ ... }).
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.ShapeCollectionLoadOptions	Stellt die Auflistung von Shapes dar.
PowerPoint.Interfaces.ShapeCollectionUpdateData	Eine Schnittstelle zum Aktualisieren von Daten für das 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 für das 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 für das 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.ShapeLoadOptions	Stellt eine einzelne Form auf der Folie dar.
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 für das ShapeScopedCollection -Objekt zur Verwendung in shapeScopedCollection.set({ ... }).
PowerPoint.Interfaces.ShapeUpdateData	Eine Schnittstelle zum Aktualisieren von Daten für das 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 für das 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.SlideLayoutCollectionLoadOptions	Stellt die Auflistung von Layouts dar, die vom Folienmaster für Folien bereitgestellt werden.
PowerPoint.Interfaces.SlideLayoutCollectionUpdateData	Eine Schnittstelle zum Aktualisieren von Daten für das 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.SlideLayoutLoadOptions	Stellt das Layout einer Folie dar.
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.SlideMasterCollectionLoadOptions	Stellt die Auflistung der Folienmaster in der Präsentation dar.
PowerPoint.Interfaces.SlideMasterCollectionUpdateData	Eine Schnittstelle zum Aktualisieren von Daten für das 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.SlideMasterLoadOptions	Stellt den Folienmaster einer Folie dar.
PowerPoint.Interfaces.SlideScopedCollectionData	Eine Schnittstelle, die die durch Aufrufen slideScopedCollection.toJSON()von zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.SlideScopedCollectionUpdateData	Eine Schnittstelle zum Aktualisieren von Daten für das 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.TagCollectionLoadOptions	Stellt die Auflistung von Tags dar.
PowerPoint.Interfaces.TagCollectionUpdateData	Eine Schnittstelle zum Aktualisieren von Daten für das 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.TagLoadOptions	Stellt ein einzelnes Tag auf der Folie dar.
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 von RequestContext von zuvor erstellten API-Objekten 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 von RequestContext von zuvor erstellten API-Objekten 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>