powerpoint package

Klassen

PowerPoint.Application
PowerPoint.BulletFormat

Stellt die Aufzählungszeichenformatierungseigenschaften eines Texts dar, der an PowerPoint.ParagraphFormat angefügt ist.

PowerPoint.ParagraphFormat

Stellt die Absatzformatierungseigenschaften eines Texts dar, der an PowerPoint.TextRange angefügt ist.

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.ShapeFill

Stellt die Füllformatierung eines Formobjekts dar.

PowerPoint.ShapeFont

Stellt die Schriftartattribute wie Schriftartname, Schriftgrad und Farbe für das TextRange-Objekt einer Form dar.

PowerPoint.ShapeLineFormat

Stellt die Linienformatierung für das Shape-Objekt dar. Bei Bildern und geometrischen Formen stellt die Linienformatierung den Rahmen der Form dar.

PowerPoint.ShapeScopedCollection

Stellt eine Auflistung von Formen 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.SlideScopedCollection

Stellt eine Auflistung von Folien in der Präsentation dar.

PowerPoint.Tag

Stellt ein einzelnes Tag auf der Folie dar.

PowerPoint.TagCollection

Stellt die Auflistung von Tags dar.

PowerPoint.TextFrame

Stellt den Textrahmen eines Formobjekts dar.

PowerPoint.TextRange

Enthält den Text, der mit einer Form verknüpft ist, sowie Eigenschaften und Methoden für das Bearbeiten des Texts.

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.BulletFormatLoadOptions

Stellt die Aufzählungszeichenformatierungseigenschaften eines Texts dar, der an PowerPoint.ParagraphFormat angefügt ist.

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.ParagraphFormatLoadOptions

Stellt die Absatzformatierungseigenschaften eines Texts dar, der an PowerPoint.TextRange angefügt ist.

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 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.ShapeFillLoadOptions

Stellt die Füllformatierung eines Formobjekts dar.

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.ShapeFontLoadOptions

Stellt die Schriftartattribute wie Schriftartname, Schriftgrad und Farbe für das TextRange-Objekt einer Form dar.

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.ShapeLineFormatLoadOptions

Stellt die Linienformatierung für das Shape-Objekt dar. Bei Bildern und geometrischen Formen stellt die Linienformatierung den Rahmen der Form dar.

PowerPoint.Interfaces.ShapeLineFormatUpdateData

Eine Schnittstelle zum Aktualisieren von Daten im 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.ShapeScopedCollectionLoadOptions

Stellt eine Auflistung von Formen dar.

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.SlideLayoutCollectionLoadOptions

Stellt die Auflistung von Layouts dar, die vom Folienmaster für Folien bereitgestellt werden.

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.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 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.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.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.TagCollectionLoadOptions

Stellt die Auflistung von Tags dar.

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.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.TextFrameLoadOptions

Stellt den Textrahmen eines Formobjekts dar.

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.TextRangeLoadOptions

Enthält den Text, der mit einer Form verknüpft ist, sowie Eigenschaften und Methoden für das Bearbeiten des Texts.

PowerPoint.Interfaces.TextRangeUpdateData

Eine Schnittstelle zum Aktualisieren von Daten für das TextRange-Objekt zur Verwendung in textRange.set({ ... }).

PowerPoint.ShapeAddOptions

Stellt die verfügbaren Optionen beim Hinzufügen von Formen dar.

PowerPoint.SlideGetImageOptions

Stellt die verfügbaren Optionen beim Abrufen eines Bilds einer Folie dar.

Enumerationen

PowerPoint.ConnectorType

Gibt den Verbindertyp für Linienformen an.

PowerPoint.ErrorCodes
PowerPoint.GeometricShapeType

Gibt den Formtyp für ein GeometricShape -Objekt an.

PowerPoint.InsertSlideFormatting

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

PowerPoint.ParagraphHorizontalAlignment

Stellt die horizontale Ausrichtung von PowerPoint.TextFrame in einer PowerPoint.Shape dar.

PowerPoint.ShapeAutoSize

Bestimmt den zulässigen Typ der automatischen Größenanpassung.

PowerPoint.ShapeFillType

Gibt den Füllungstyp einer Form an.

PowerPoint.ShapeFontUnderlineStyle

Der Auf eine Schriftart angewendete Unterstreichungstyp.

PowerPoint.ShapeLineDashStyle

Gibt die Strichart für eine Linie an.

PowerPoint.ShapeLineStyle

Gibt die Linienart an.

PowerPoint.ShapeType

Gibt den Typ einer Form an.

PowerPoint.TextVerticalAlignment

Stellt die vertikale Ausrichtung eines PowerPoint.TextFrame in einer PowerPoint.Shape dar. Wenn eine der zentrierten Optionen ausgewählt ist, wird der Inhalt des TextFrame horizontal innerhalb der Shape als Gruppe zentriert. Informationen zum Ändern der horizontalen Ausrichtung eines Texts finden Sie unter PowerPoint.ParagraphFormat und PowerPoint.ParagraphHorizontalAlignment.

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

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

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