powerpoint package

Klassen

PowerPoint.Application	Stellt die PowerPoint-Anwendung dar, die die Präsentation verwaltet.
PowerPoint.Presentation	Das `Presentation` Objekt ist das Objekt der obersten Ebene mit einer oder mehreren Folien, die den Inhalt der Präsentation enthalten. Weitere Informationen zum PowerPoint-Objektmodell finden Sie unter PowerPoint-JavaScript-Objektmodell.
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 vom Add-In aus Zugriff auf das PowerPoint-Objektmodell zu erhalten.
PowerPoint.Slide	Stellt eine einzelne Folie einer Präsentation dar.
PowerPoint.SlideCollection	Stellt die Sammlung von Folien in der Präsentation dar.

Schnittstellen

PowerPoint.InsertSlideOptions	Stellt die verfügbaren Optionen beim Einfügen von Folien dar.
PowerPoint.Interfaces.AdjustmentsData	Eine Schnittstelle, die die durch Aufrufen `adjustments.toJSON()`zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.BindingCollectionData	Eine Schnittstelle, die die durch Aufrufen `bindingCollection.toJSON()`zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.BindingCollectionUpdateData	Eine Schnittstelle zum Aktualisieren von Daten über das `BindingCollection` Objekt, zur Verwendung in `bindingCollection.set({ ... })`.
PowerPoint.Interfaces.BindingData	Eine Schnittstelle, die die durch Aufrufen `binding.toJSON()`zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.BorderData	Eine Schnittstelle, die die durch Aufrufen `border.toJSON()`zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.BordersData	Eine Schnittstelle, die die durch Aufrufen `borders.toJSON()`zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.BorderUpdateData	Eine Schnittstelle zum Aktualisieren von Daten über das `Border` Objekt, zur Verwendung in `border.set({ ... })`.
PowerPoint.Interfaces.BulletFormatData	Eine Schnittstelle, die die durch Aufrufen `bulletFormat.toJSON()`zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.BulletFormatUpdateData	Eine Schnittstelle zum Aktualisieren von Daten über das `BulletFormat` Objekt, zur Verwendung in `bulletFormat.set({ ... })`.
PowerPoint.Interfaces.CollectionLoadOptions	Bietet Möglichkeiten zum Laden von Eigenschaften nur einer Teilmenge von Elementen einer Auflistung.
PowerPoint.Interfaces.CustomPropertyCollectionData	Eine Schnittstelle, die die durch Aufrufen `customPropertyCollection.toJSON()`zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.CustomPropertyCollectionUpdateData	Eine Schnittstelle zum Aktualisieren von Daten über das `CustomPropertyCollection` Objekt, zur Verwendung in `customPropertyCollection.set({ ... })`.
PowerPoint.Interfaces.CustomPropertyData	Eine Schnittstelle, die die durch Aufrufen `customProperty.toJSON()`zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.CustomPropertyUpdateData	Eine Schnittstelle zum Aktualisieren von Daten über das `CustomProperty` Objekt, zur Verwendung in `customProperty.set({ ... })`.
PowerPoint.Interfaces.CustomXmlPartCollectionData	Eine Schnittstelle, die die durch Aufrufen `customXmlPartCollection.toJSON()`zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.CustomXmlPartCollectionUpdateData	Eine Schnittstelle zum Aktualisieren von Daten über das `CustomXmlPartCollection` Objekt, zur Verwendung in `customXmlPartCollection.set({ ... })`.
PowerPoint.Interfaces.CustomXmlPartData	Eine Schnittstelle, die die durch Aufrufen `customXmlPart.toJSON()`zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.CustomXmlPartScopedCollectionData	Eine Schnittstelle, die die durch Aufrufen `customXmlPartScopedCollection.toJSON()`zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.CustomXmlPartScopedCollectionUpdateData	Eine Schnittstelle zum Aktualisieren von Daten über das `CustomXmlPartScopedCollection` Objekt, zur Verwendung in `customXmlPartScopedCollection.set({ ... })`.
PowerPoint.Interfaces.DocumentPropertiesData	Eine Schnittstelle, die die durch Aufrufen `documentProperties.toJSON()`zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.DocumentPropertiesUpdateData	Eine Schnittstelle zum Aktualisieren von Daten über das `DocumentProperties` Objekt, zur Verwendung in `documentProperties.set({ ... })`.
PowerPoint.Interfaces.HyperlinkCollectionData	Eine Schnittstelle, die die durch Aufrufen `hyperlinkCollection.toJSON()`zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.HyperlinkCollectionUpdateData	Eine Schnittstelle zum Aktualisieren von Daten über das `HyperlinkCollection` Objekt, zur Verwendung in `hyperlinkCollection.set({ ... })`.
PowerPoint.Interfaces.HyperlinkData	Eine Schnittstelle, die die durch Aufrufen `hyperlink.toJSON()`zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.HyperlinkScopedCollectionData	Eine Schnittstelle, die die durch Aufrufen `hyperlinkScopedCollection.toJSON()`zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.HyperlinkScopedCollectionUpdateData	Eine Schnittstelle zum Aktualisieren von Daten über das `HyperlinkScopedCollection` Objekt, zur Verwendung in `hyperlinkScopedCollection.set({ ... })`.
PowerPoint.Interfaces.HyperlinkUpdateData	Eine Schnittstelle zum Aktualisieren von Daten über das `Hyperlink` Objekt, zur Verwendung in `hyperlink.set({ ... })`.
PowerPoint.Interfaces.MarginsData	Eine Schnittstelle, die die durch Aufrufen `margins.toJSON()`zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.MarginsUpdateData	Eine Schnittstelle zum Aktualisieren von Daten über das `Margins` Objekt, zur Verwendung in `margins.set({ ... })`.
PowerPoint.Interfaces.PageSetupData	Eine Schnittstelle, die die durch Aufrufen `pageSetup.toJSON()`zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.PageSetupUpdateData	Eine Schnittstelle zum Aktualisieren von Daten über das `PageSetup` Objekt, zur Verwendung in `pageSetup.set({ ... })`.
PowerPoint.Interfaces.ParagraphFormatData	Eine Schnittstelle, die die durch Aufrufen `paragraphFormat.toJSON()`zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.ParagraphFormatUpdateData	Eine Schnittstelle zum Aktualisieren von Daten über das `ParagraphFormat` Objekt, zur Verwendung in `paragraphFormat.set({ ... })`.
PowerPoint.Interfaces.PlaceholderFormatData	Eine Schnittstelle, die die durch Aufrufen `placeholderFormat.toJSON()`zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.PresentationData	Eine Schnittstelle, die die durch Aufrufen `presentation.toJSON()`zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.PresentationLoadOptions	Das `Presentation` Objekt ist das Objekt der obersten Ebene mit einer oder mehreren Folien, die den Inhalt der Präsentation enthalten. Weitere Informationen zum PowerPoint-Objektmodell finden Sie unter PowerPoint-JavaScript-Objektmodell.
PowerPoint.Interfaces.ShapeCollectionData	Eine Schnittstelle, die die durch Aufrufen `shapeCollection.toJSON()`zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.ShapeCollectionUpdateData	Eine Schnittstelle zum Aktualisieren von Daten über das `ShapeCollection` Objekt, zur Verwendung in `shapeCollection.set({ ... })`.
PowerPoint.Interfaces.ShapeData	Eine Schnittstelle, die die durch Aufrufen `shape.toJSON()`zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.ShapeFillData	Eine Schnittstelle, die die durch Aufrufen `shapeFill.toJSON()`zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.ShapeFillUpdateData	Eine Schnittstelle zum Aktualisieren von Daten über das `ShapeFill` Objekt, zur Verwendung in `shapeFill.set({ ... })`.
PowerPoint.Interfaces.ShapeFontData	Eine Schnittstelle, die die durch Aufrufen `shapeFont.toJSON()`zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.ShapeFontUpdateData	Eine Schnittstelle zum Aktualisieren von Daten über das `ShapeFont` Objekt, zur Verwendung in `shapeFont.set({ ... })`.
PowerPoint.Interfaces.ShapeGroupData	Eine Schnittstelle, die die durch Aufrufen `shapeGroup.toJSON()`zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.ShapeLineFormatData	Eine Schnittstelle, die die durch Aufrufen `shapeLineFormat.toJSON()`zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.ShapeLineFormatUpdateData	Eine Schnittstelle zum Aktualisieren von Daten über das `ShapeLineFormat` Objekt, zur Verwendung in `shapeLineFormat.set({ ... })`.
PowerPoint.Interfaces.ShapeScopedCollectionData	Eine Schnittstelle, die die durch Aufrufen `shapeScopedCollection.toJSON()`zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.ShapeScopedCollectionUpdateData	Eine Schnittstelle zum Aktualisieren von Daten über das `ShapeScopedCollection` Objekt, zur Verwendung in `shapeScopedCollection.set({ ... })`.
PowerPoint.Interfaces.ShapeUpdateData	Eine Schnittstelle zum Aktualisieren von Daten über das `Shape` Objekt, zur Verwendung in `shape.set({ ... })`.
PowerPoint.Interfaces.SlideBackgroundData	Eine Schnittstelle, die die durch Aufrufen `slideBackground.toJSON()`zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.SlideBackgroundFillData	Eine Schnittstelle, die die durch Aufrufen `slideBackgroundFill.toJSON()`zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.SlideBackgroundGradientFillData	Eine Schnittstelle, die die durch Aufrufen `slideBackgroundGradientFill.toJSON()`zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.SlideBackgroundGradientFillUpdateData	Eine Schnittstelle zum Aktualisieren von Daten über das `SlideBackgroundGradientFill` Objekt, zur Verwendung in `slideBackgroundGradientFill.set({ ... })`.
PowerPoint.Interfaces.SlideBackgroundPatternFillData	Eine Schnittstelle, die die durch Aufrufen `slideBackgroundPatternFill.toJSON()`zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.SlideBackgroundPatternFillUpdateData	Eine Schnittstelle zum Aktualisieren von Daten über das `SlideBackgroundPatternFill` Objekt, zur Verwendung in `slideBackgroundPatternFill.set({ ... })`.
PowerPoint.Interfaces.SlideBackgroundPictureOrTextureFillData	Eine Schnittstelle, die die durch Aufrufen `slideBackgroundPictureOrTextureFill.toJSON()`zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.SlideBackgroundPictureOrTextureFillUpdateData	Eine Schnittstelle zum Aktualisieren von Daten über das `SlideBackgroundPictureOrTextureFill` Objekt, zur Verwendung in `slideBackgroundPictureOrTextureFill.set({ ... })`.
PowerPoint.Interfaces.SlideBackgroundSolidFillData	Eine Schnittstelle, die die durch Aufrufen `slideBackgroundSolidFill.toJSON()`zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.SlideBackgroundSolidFillUpdateData	Eine Schnittstelle zum Aktualisieren von Daten über das `SlideBackgroundSolidFill` Objekt, zur Verwendung in `slideBackgroundSolidFill.set({ ... })`.
PowerPoint.Interfaces.SlideBackgroundUpdateData	Eine Schnittstelle zum Aktualisieren von Daten über das `SlideBackground` Objekt, zur Verwendung in `slideBackground.set({ ... })`.
PowerPoint.Interfaces.SlideCollectionData	Eine Schnittstelle, die die durch Aufrufen `slideCollection.toJSON()`zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.SlideCollectionLoadOptions	Stellt die Sammlung von Folien in der Präsentation dar.
PowerPoint.Interfaces.SlideCollectionUpdateData	Eine Schnittstelle zum Aktualisieren von Daten über das `SlideCollection` Objekt, zur Verwendung in `slideCollection.set({ ... })`.
PowerPoint.Interfaces.SlideData	Eine Schnittstelle, die die durch Aufrufen `slide.toJSON()`zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.SlideLayoutBackgroundData	Eine Schnittstelle, die die durch Aufrufen `slideLayoutBackground.toJSON()`zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.SlideLayoutBackgroundUpdateData	Eine Schnittstelle zum Aktualisieren von Daten über das `SlideLayoutBackground` Objekt, zur Verwendung in `slideLayoutBackground.set({ ... })`.
PowerPoint.Interfaces.SlideLayoutCollectionData	Eine Schnittstelle, die die durch Aufrufen `slideLayoutCollection.toJSON()`zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.SlideLayoutCollectionUpdateData	Eine Schnittstelle zum Aktualisieren von Daten über das `SlideLayoutCollection` Objekt, zur Verwendung in `slideLayoutCollection.set({ ... })`.
PowerPoint.Interfaces.SlideLayoutData	Eine Schnittstelle, die die durch Aufrufen `slideLayout.toJSON()`zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.SlideLoadOptions	Stellt eine einzelne Folie einer Präsentation dar.
PowerPoint.Interfaces.SlideMasterBackgroundData	Eine Schnittstelle, die die durch Aufrufen `slideMasterBackground.toJSON()`zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.SlideMasterCollectionData	Eine Schnittstelle, die die durch Aufrufen `slideMasterCollection.toJSON()`zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.SlideMasterCollectionUpdateData	Eine Schnittstelle zum Aktualisieren von Daten über das `SlideMasterCollection` Objekt, zur Verwendung in `slideMasterCollection.set({ ... })`.
PowerPoint.Interfaces.SlideMasterData	Eine Schnittstelle, die die durch Aufrufen `slideMaster.toJSON()`zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.SlideScopedCollectionData	Eine Schnittstelle, die die durch Aufrufen `slideScopedCollection.toJSON()`zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.SlideScopedCollectionUpdateData	Eine Schnittstelle zum Aktualisieren von Daten über das `SlideScopedCollection` Objekt, zur Verwendung in `slideScopedCollection.set({ ... })`.
PowerPoint.Interfaces.TableCellCollectionData	Eine Schnittstelle, die die durch Aufrufen `tableCellCollection.toJSON()`zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.TableCellCollectionUpdateData	Eine Schnittstelle zum Aktualisieren von Daten über das `TableCellCollection` Objekt, zur Verwendung in `tableCellCollection.set({ ... })`.
PowerPoint.Interfaces.TableCellData	Eine Schnittstelle, die die durch Aufrufen `tableCell.toJSON()`zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.TableCellUpdateData	Eine Schnittstelle zum Aktualisieren von Daten über das `TableCell` Objekt, zur Verwendung in `tableCell.set({ ... })`.
PowerPoint.Interfaces.TableColumnCollectionData	Eine Schnittstelle, die die durch Aufrufen `tableColumnCollection.toJSON()`zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.TableColumnCollectionUpdateData	Eine Schnittstelle zum Aktualisieren von Daten über das `TableColumnCollection` Objekt, zur Verwendung in `tableColumnCollection.set({ ... })`.
PowerPoint.Interfaces.TableColumnData	Eine Schnittstelle, die die durch Aufrufen `tableColumn.toJSON()`zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.TableColumnUpdateData	Eine Schnittstelle zum Aktualisieren von Daten über das `TableColumn` Objekt, zur Verwendung in `tableColumn.set({ ... })`.
PowerPoint.Interfaces.TableData	Eine Schnittstelle, die die durch Aufrufen `table.toJSON()`zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.TableRowCollectionData	Eine Schnittstelle, die die durch Aufrufen `tableRowCollection.toJSON()`zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.TableRowCollectionUpdateData	Eine Schnittstelle zum Aktualisieren von Daten über das `TableRowCollection` Objekt, zur Verwendung in `tableRowCollection.set({ ... })`.
PowerPoint.Interfaces.TableRowData	Eine Schnittstelle, die die durch Aufrufen `tableRow.toJSON()`zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.TableRowUpdateData	Eine Schnittstelle zum Aktualisieren von Daten über das `TableRow` Objekt, zur Verwendung in `tableRow.set({ ... })`.
PowerPoint.Interfaces.TableStyleSettingsData	Eine Schnittstelle, die die durch Aufrufen `tableStyleSettings.toJSON()`zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.TableStyleSettingsUpdateData	Eine Schnittstelle zum Aktualisieren von Daten über das `TableStyleSettings` Objekt, zur Verwendung in `tableStyleSettings.set({ ... })`.
PowerPoint.Interfaces.TagCollectionData	Eine Schnittstelle, die die durch Aufrufen `tagCollection.toJSON()`zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.TagCollectionUpdateData	Eine Schnittstelle zum Aktualisieren von Daten über das `TagCollection` Objekt, zur Verwendung in `tagCollection.set({ ... })`.
PowerPoint.Interfaces.TagData	Eine Schnittstelle, die die durch Aufrufen `tag.toJSON()`zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.TagUpdateData	Eine Schnittstelle zum Aktualisieren von Daten über das `Tag` Objekt, zur Verwendung in `tag.set({ ... })`.
PowerPoint.Interfaces.TextFrameData	Eine Schnittstelle, die die durch Aufrufen `textFrame.toJSON()`zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.TextFrameUpdateData	Eine Schnittstelle zum Aktualisieren von Daten über das `TextFrame` Objekt, zur Verwendung in `textFrame.set({ ... })`.
PowerPoint.Interfaces.TextRangeData	Eine Schnittstelle, die die durch Aufrufen `textRange.toJSON()`zurückgegebenen Daten beschreibt.
PowerPoint.Interfaces.TextRangeUpdateData	Eine Schnittstelle zum Aktualisieren von Daten über das `TextRange` Objekt, zur Verwendung in `textRange.set({ ... })`.

Enumerationen

PowerPoint.ErrorCodes
PowerPoint.InsertSlideFormatting	Gibt die Formatierungsoptionen an, wenn Folien eingefügt werden.

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 mithilfe 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 mithilfe 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 mithilfe des RequestContext zuvor erstellter API-Objekte ausführt.

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. Die maximale Länge der Zeichenfolge beträgt 71.680.000 Zeichen.

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 mithilfe 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 aufnimmt und eine Zusage zurückgibt (in der Regel nur das Ergebnis von "context.sync()"). Der context-Parameter 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 vom Add-In aus Zugriff auf das PowerPoint-Objektmodell zu erhalten.

Gibt zurück

OfficeExtension.IPromise<T>

Beispiele

// *.run methods automatically create an OfficeExtension.ClientRequestContext
// object to work with the Office file.
await PowerPoint.run(async (context) => {
  const presentation = context.presentation;
  // Interact with the PowerPoint presentation...
});

PowerPoint.run(object, batch)

Führt ein Batchskript aus, das Aktionen für das PowerPoint-Objektmodell mithilfe 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 auf das Objekt angewendeten Änderungen von "context.sync()" übernommen werden.

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

Eine Funktion, die einen RequestContext aufnimmt und eine Zusage zurückgibt (in der Regel nur das Ergebnis von "context.sync()"). Der context-Parameter 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 vom Add-In aus Zugriff auf das PowerPoint-Objektmodell zu erhalten.

Gibt zurück

OfficeExtension.IPromise<T>

PowerPoint.run(objects, batch)

Führt ein Batchskript aus, das Aktionen für das PowerPoint-Objektmodell mithilfe des RequestContext zuvor erstellter 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 zuvor erstellter API-Objekte. Das Array wird überprüft, um sicherzustellen, dass alle Objekte denselben Kontext haben. Der Batch verwendet diesen freigegebenen RequestContext, was bedeutet, dass alle auf diese Objekte angewendeten Änderungen von "context.sync()" übernommen werden.

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

Eine Funktion, die einen RequestContext aufnimmt und eine Zusage zurückgibt (in der Regel nur das Ergebnis von "context.sync()"). Der context-Parameter 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 vom Add-In aus Zugriff auf das PowerPoint-Objektmodell zu erhalten.

Gibt zurück

OfficeExtension.IPromise<T>

Klassen

Schnittstellen

Enumerationen

Functions

Details zur Funktion

PowerPoint.createPresentation(base64File)

Parameter

Gibt zurück

Beispiele

PowerPoint.run(batch)

Parameter

Gibt zurück

Beispiele

PowerPoint.run(object, batch)

Parameter

Gibt zurück

PowerPoint.run(objects, batch)

Parameter

Gibt zurück

Feedback