powerpoint package

Classes

PowerPoint.Application
PowerPoint.Binding	Represents an Office.js binding that is defined in the presentation.
PowerPoint.BindingCollection	Represents the collection of all the binding objects that are part of the presentation.
PowerPoint.BulletFormat	Represents the bullet formatting properties of a text that is attached to the PowerPoint.ParagraphFormat.
PowerPoint.CustomProperty	Represents a custom property.
PowerPoint.CustomPropertyCollection	A collection of custom properties.
PowerPoint.CustomXmlPart	Represents a custom XML part object.
PowerPoint.CustomXmlPartCollection	A collection of custom XML parts.
PowerPoint.CustomXmlPartScopedCollection	A scoped collection of custom XML parts. A scoped collection is the result of some operation (such as filtering by namespace). A scoped collection cannot be scoped any further.
PowerPoint.DocumentProperties	Represents presentation properties.
PowerPoint.Hyperlink	Represents a single hyperlink.
PowerPoint.HyperlinkCollection	Represents a collection of hyperlinks.
PowerPoint.ParagraphFormat	Represents the paragraph formatting properties of a text that is attached to the PowerPoint.TextRange.
PowerPoint.PlaceholderFormat	Represents the properties of a placeholder shape.
PowerPoint.Presentation
PowerPoint.RequestContext	The RequestContext object facilitates requests to the PowerPoint application. Since the Office add-in and the PowerPoint application run in two different processes, the request context is required to get access to the PowerPoint object model from the add-in.
PowerPoint.Shape	Represents a single shape in the slide.
PowerPoint.ShapeCollection	Represents the collection of shapes.
PowerPoint.ShapeFill	Represents the fill formatting of a shape object.
PowerPoint.ShapeFont	Represents the font attributes, such as font name, font size, and color, for a shape's TextRange object.
PowerPoint.ShapeGroup	Represents a shape group inside a presentation. To get the corresponding Shape object, use ShapeGroup.shape.
PowerPoint.ShapeLineFormat	Represents the line formatting for the shape object. For images and geometric shapes, line formatting represents the border of the shape.
PowerPoint.ShapeScopedCollection	Represents a collection of shapes.
PowerPoint.Slide	Represents a single slide of a presentation.
PowerPoint.SlideCollection	Represents the collection of slides in the presentation.
PowerPoint.SlideLayout	Represents the layout of a slide.
PowerPoint.SlideLayoutCollection	Represents the collection of layouts provided by the Slide Master for slides.
PowerPoint.SlideMaster	Represents the Slide Master of a slide.
PowerPoint.SlideMasterCollection	Represents the collection of Slide Masters in the presentation.
PowerPoint.SlideScopedCollection	Represents a collection of slides in the presentation.
PowerPoint.Table	Represents a table.
PowerPoint.TableCell	Represents a table.
PowerPoint.TableCellCollection	Represents a collection of table cells.
PowerPoint.Tag	Represents a single tag in the slide.
PowerPoint.TagCollection	Represents the collection of tags.
PowerPoint.TextFrame	Represents the text frame of a shape object.
PowerPoint.TextRange	Contains the text that is attached to a shape, in addition to properties and methods for manipulating the text.

Interfaces

PowerPoint.AddSlideOptions	Represents the available options when adding a new slide.
PowerPoint.BorderProperties	Represents the properties for a table cell border.
PowerPoint.FillProperties	Represents the fill formatting of a table cell.
PowerPoint.FontProperties	Represents the font attributes, such as font name, size, and color.
PowerPoint.InsertSlideOptions	Represents the available options when inserting slides.
PowerPoint.Interfaces.BindingCollectionData	An interface describing the data returned by calling bindingCollection.toJSON().
PowerPoint.Interfaces.BindingCollectionLoadOptions	Represents the collection of all the binding objects that are part of the presentation.
PowerPoint.Interfaces.BindingCollectionUpdateData	An interface for updating data on the BindingCollection object, for use in bindingCollection.set({ ... }).
PowerPoint.Interfaces.BindingData	An interface describing the data returned by calling binding.toJSON().
PowerPoint.Interfaces.BindingLoadOptions	Represents an Office.js binding that is defined in the presentation.
PowerPoint.Interfaces.BulletFormatData	An interface describing the data returned by calling bulletFormat.toJSON().
PowerPoint.Interfaces.BulletFormatLoadOptions	Represents the bullet formatting properties of a text that is attached to the PowerPoint.ParagraphFormat.
PowerPoint.Interfaces.BulletFormatUpdateData	An interface for updating data on the BulletFormat object, for use in bulletFormat.set({ ... }).
PowerPoint.Interfaces.CollectionLoadOptions	Provides ways to load properties of only a subset of members of a collection.
PowerPoint.Interfaces.CustomPropertyCollectionData	An interface describing the data returned by calling customPropertyCollection.toJSON().
PowerPoint.Interfaces.CustomPropertyCollectionLoadOptions	A collection of custom properties.
PowerPoint.Interfaces.CustomPropertyCollectionUpdateData	An interface for updating data on the CustomPropertyCollection object, for use in customPropertyCollection.set({ ... }).
PowerPoint.Interfaces.CustomPropertyData	An interface describing the data returned by calling customProperty.toJSON().
PowerPoint.Interfaces.CustomPropertyLoadOptions	Represents a custom property.
PowerPoint.Interfaces.CustomPropertyUpdateData	An interface for updating data on the CustomProperty object, for use in customProperty.set({ ... }).
PowerPoint.Interfaces.CustomXmlPartCollectionData	An interface describing the data returned by calling customXmlPartCollection.toJSON().
PowerPoint.Interfaces.CustomXmlPartCollectionLoadOptions	A collection of custom XML parts.
PowerPoint.Interfaces.CustomXmlPartCollectionUpdateData	An interface for updating data on the CustomXmlPartCollection object, for use in customXmlPartCollection.set({ ... }).
PowerPoint.Interfaces.CustomXmlPartData	An interface describing the data returned by calling customXmlPart.toJSON().
PowerPoint.Interfaces.CustomXmlPartLoadOptions	Represents a custom XML part object.
PowerPoint.Interfaces.CustomXmlPartScopedCollectionData	An interface describing the data returned by calling customXmlPartScopedCollection.toJSON().
PowerPoint.Interfaces.CustomXmlPartScopedCollectionLoadOptions	A scoped collection of custom XML parts. A scoped collection is the result of some operation (such as filtering by namespace). A scoped collection cannot be scoped any further.
PowerPoint.Interfaces.CustomXmlPartScopedCollectionUpdateData	An interface for updating data on the CustomXmlPartScopedCollection object, for use in customXmlPartScopedCollection.set({ ... }).
PowerPoint.Interfaces.DocumentPropertiesData	An interface describing the data returned by calling documentProperties.toJSON().
PowerPoint.Interfaces.DocumentPropertiesLoadOptions	Represents presentation properties.
PowerPoint.Interfaces.DocumentPropertiesUpdateData	An interface for updating data on the DocumentProperties object, for use in documentProperties.set({ ... }).
PowerPoint.Interfaces.HyperlinkCollectionData	An interface describing the data returned by calling hyperlinkCollection.toJSON().
PowerPoint.Interfaces.HyperlinkCollectionLoadOptions	Represents a collection of hyperlinks.
PowerPoint.Interfaces.HyperlinkCollectionUpdateData	An interface for updating data on the HyperlinkCollection object, for use in hyperlinkCollection.set({ ... }).
PowerPoint.Interfaces.HyperlinkData	An interface describing the data returned by calling hyperlink.toJSON().
PowerPoint.Interfaces.HyperlinkLoadOptions	Represents a single hyperlink.
PowerPoint.Interfaces.HyperlinkUpdateData	An interface for updating data on the Hyperlink object, for use in hyperlink.set({ ... }).
PowerPoint.Interfaces.ParagraphFormatData	An interface describing the data returned by calling paragraphFormat.toJSON().
PowerPoint.Interfaces.ParagraphFormatLoadOptions	Represents the paragraph formatting properties of a text that is attached to the PowerPoint.TextRange.
PowerPoint.Interfaces.ParagraphFormatUpdateData	An interface for updating data on the ParagraphFormat object, for use in paragraphFormat.set({ ... }).
PowerPoint.Interfaces.PlaceholderFormatData	An interface describing the data returned by calling placeholderFormat.toJSON().
PowerPoint.Interfaces.PlaceholderFormatLoadOptions	Represents the properties of a placeholder shape.
PowerPoint.Interfaces.PresentationData	An interface describing the data returned by calling presentation.toJSON().
PowerPoint.Interfaces.PresentationLoadOptions
PowerPoint.Interfaces.ShapeCollectionData	An interface describing the data returned by calling shapeCollection.toJSON().
PowerPoint.Interfaces.ShapeCollectionLoadOptions	Represents the collection of shapes.
PowerPoint.Interfaces.ShapeCollectionUpdateData	An interface for updating data on the ShapeCollection object, for use in shapeCollection.set({ ... }).
PowerPoint.Interfaces.ShapeData	An interface describing the data returned by calling shape.toJSON().
PowerPoint.Interfaces.ShapeFillData	An interface describing the data returned by calling shapeFill.toJSON().
PowerPoint.Interfaces.ShapeFillLoadOptions	Represents the fill formatting of a shape object.
PowerPoint.Interfaces.ShapeFillUpdateData	An interface for updating data on the ShapeFill object, for use in shapeFill.set({ ... }).
PowerPoint.Interfaces.ShapeFontData	An interface describing the data returned by calling shapeFont.toJSON().
PowerPoint.Interfaces.ShapeFontLoadOptions	Represents the font attributes, such as font name, font size, and color, for a shape's TextRange object.
PowerPoint.Interfaces.ShapeFontUpdateData	An interface for updating data on the ShapeFont object, for use in shapeFont.set({ ... }).
PowerPoint.Interfaces.ShapeGroupData	An interface describing the data returned by calling shapeGroup.toJSON().
PowerPoint.Interfaces.ShapeGroupLoadOptions	Represents a shape group inside a presentation. To get the corresponding Shape object, use ShapeGroup.shape.
PowerPoint.Interfaces.ShapeLineFormatData	An interface describing the data returned by calling shapeLineFormat.toJSON().
PowerPoint.Interfaces.ShapeLineFormatLoadOptions	Represents the line formatting for the shape object. For images and geometric shapes, line formatting represents the border of the shape.
PowerPoint.Interfaces.ShapeLineFormatUpdateData	An interface for updating data on the ShapeLineFormat object, for use in shapeLineFormat.set({ ... }).
PowerPoint.Interfaces.ShapeLoadOptions	Represents a single shape in the slide.
PowerPoint.Interfaces.ShapeScopedCollectionData	An interface describing the data returned by calling shapeScopedCollection.toJSON().
PowerPoint.Interfaces.ShapeScopedCollectionLoadOptions	Represents a collection of shapes.
PowerPoint.Interfaces.ShapeScopedCollectionUpdateData	An interface for updating data on the ShapeScopedCollection object, for use in shapeScopedCollection.set({ ... }).
PowerPoint.Interfaces.ShapeUpdateData	An interface for updating data on the Shape object, for use in shape.set({ ... }).
PowerPoint.Interfaces.SlideCollectionData	An interface describing the data returned by calling slideCollection.toJSON().
PowerPoint.Interfaces.SlideCollectionLoadOptions	Represents the collection of slides in the presentation.
PowerPoint.Interfaces.SlideCollectionUpdateData	An interface for updating data on the SlideCollection object, for use in slideCollection.set({ ... }).
PowerPoint.Interfaces.SlideData	An interface describing the data returned by calling slide.toJSON().
PowerPoint.Interfaces.SlideLayoutCollectionData	An interface describing the data returned by calling slideLayoutCollection.toJSON().
PowerPoint.Interfaces.SlideLayoutCollectionLoadOptions	Represents the collection of layouts provided by the Slide Master for slides.
PowerPoint.Interfaces.SlideLayoutCollectionUpdateData	An interface for updating data on the SlideLayoutCollection object, for use in slideLayoutCollection.set({ ... }).
PowerPoint.Interfaces.SlideLayoutData	An interface describing the data returned by calling slideLayout.toJSON().
PowerPoint.Interfaces.SlideLayoutLoadOptions	Represents the layout of a slide.
PowerPoint.Interfaces.SlideLoadOptions	Represents a single slide of a presentation.
PowerPoint.Interfaces.SlideMasterCollectionData	An interface describing the data returned by calling slideMasterCollection.toJSON().
PowerPoint.Interfaces.SlideMasterCollectionLoadOptions	Represents the collection of Slide Masters in the presentation.
PowerPoint.Interfaces.SlideMasterCollectionUpdateData	An interface for updating data on the SlideMasterCollection object, for use in slideMasterCollection.set({ ... }).
PowerPoint.Interfaces.SlideMasterData	An interface describing the data returned by calling slideMaster.toJSON().
PowerPoint.Interfaces.SlideMasterLoadOptions	Represents the Slide Master of a slide.
PowerPoint.Interfaces.SlideScopedCollectionData	An interface describing the data returned by calling slideScopedCollection.toJSON().
PowerPoint.Interfaces.SlideScopedCollectionLoadOptions	Represents a collection of slides in the presentation.
PowerPoint.Interfaces.SlideScopedCollectionUpdateData	An interface for updating data on the SlideScopedCollection object, for use in slideScopedCollection.set({ ... }).
PowerPoint.Interfaces.TableCellCollectionData	An interface describing the data returned by calling tableCellCollection.toJSON().
PowerPoint.Interfaces.TableCellCollectionLoadOptions	Represents a collection of table cells.
PowerPoint.Interfaces.TableCellCollectionUpdateData	An interface for updating data on the TableCellCollection object, for use in tableCellCollection.set({ ... }).
PowerPoint.Interfaces.TableCellData	An interface describing the data returned by calling tableCell.toJSON().
PowerPoint.Interfaces.TableCellLoadOptions	Represents a table.
PowerPoint.Interfaces.TableCellUpdateData	An interface for updating data on the TableCell object, for use in tableCell.set({ ... }).
PowerPoint.Interfaces.TableData	An interface describing the data returned by calling table.toJSON().
PowerPoint.Interfaces.TableLoadOptions	Represents a table.
PowerPoint.Interfaces.TagCollectionData	An interface describing the data returned by calling tagCollection.toJSON().
PowerPoint.Interfaces.TagCollectionLoadOptions	Represents the collection of tags.
PowerPoint.Interfaces.TagCollectionUpdateData	An interface for updating data on the TagCollection object, for use in tagCollection.set({ ... }).
PowerPoint.Interfaces.TagData	An interface describing the data returned by calling tag.toJSON().
PowerPoint.Interfaces.TagLoadOptions	Represents a single tag in the slide.
PowerPoint.Interfaces.TagUpdateData	An interface for updating data on the Tag object, for use in tag.set({ ... }).
PowerPoint.Interfaces.TextFrameData	An interface describing the data returned by calling textFrame.toJSON().
PowerPoint.Interfaces.TextFrameLoadOptions	Represents the text frame of a shape object.
PowerPoint.Interfaces.TextFrameUpdateData	An interface for updating data on the TextFrame object, for use in textFrame.set({ ... }).
PowerPoint.Interfaces.TextRangeData	An interface describing the data returned by calling textRange.toJSON().
PowerPoint.Interfaces.TextRangeLoadOptions	Contains the text that is attached to a shape, in addition to properties and methods for manipulating the text.
PowerPoint.Interfaces.TextRangeUpdateData	An interface for updating data on the TextRange object, for use in textRange.set({ ... }).
PowerPoint.ShapeAddOptions	Represents the available options when adding shapes.
PowerPoint.SlideGetImageOptions	Represents the available options when getting an image of a slide.
PowerPoint.TableAddOptions	Represents the available options when adding a table.
PowerPoint.TableCellBorders	Represents the borders of a table cell.
PowerPoint.TableCellMargins	Represents the margins of a table cell.
PowerPoint.TableCellProperties	Represents the table cell properties to update.
PowerPoint.TableColumnProperties	Provides the table column properties.
PowerPoint.TableMergedAreaProperties	Represents the properties of a merged area of cells in a table.
PowerPoint.TableRowProperties	Provides the table row properties.
PowerPoint.TextRun	Represents a sequence of one or more characters with the same font attributes.

Enums

PowerPoint.BindingType	Represents the possible binding types.
PowerPoint.ConnectorType	Specifies the connector type for line shapes.
PowerPoint.DocumentPropertyType	Specifies the document property type for custom properties.
PowerPoint.ErrorCodes
PowerPoint.GeometricShapeType	Specifies the shape type for a GeometricShape object.
PowerPoint.InsertSlideFormatting	Specifies the formatting options for when slides are inserted.
PowerPoint.ParagraphHorizontalAlignment	Represents the horizontal alignment of the PowerPoint.TextFrame in a PowerPoint.Shape.
PowerPoint.PlaceholderType	Specifies the type of a placeholder.
PowerPoint.ShapeAutoSize	Determines the type of automatic sizing allowed.
PowerPoint.ShapeFillType	Specifies a shape's fill type.
PowerPoint.ShapeFontUnderlineStyle	The type of underline applied to a font.
PowerPoint.ShapeLineDashStyle	Specifies the dash style for a line.
PowerPoint.ShapeLineStyle	Specifies the style for a line.
PowerPoint.ShapeType	Specifies the type of a shape.
PowerPoint.ShapeZOrder	Use with setZOrder to move the specified shape up or down the collection's z-order, which shifts it in front of or behind other shapes.
PowerPoint.SlideLayoutType	Specifies the type of a slide layout.
PowerPoint.TextVerticalAlignment	Represents the vertical alignment of a PowerPoint.TextFrame in a PowerPoint.Shape. If one the centered options are selected, the contents of the TextFrame will be centered horizontally within the Shape as a group. To change the horizontal alignment of a text, see PowerPoint.ParagraphFormat and PowerPoint.ParagraphHorizontalAlignment.

Functions

PowerPoint.createPresentation(base64File)	Creates and opens a new presentation. Optionally, the presentation can be pre-populated with a Base64-encoded .pptx file. [ API set: PowerPointApi 1.1 ]
PowerPoint.run(batch)	Executes a batch script that performs actions on the PowerPoint object model, using a new RequestContext. When the promise is resolved, any tracked objects that were automatically allocated during execution will be released.
PowerPoint.run(object, batch)	Executes a batch script that performs actions on the PowerPoint object model, using the RequestContext of a previously-created API object. When the promise is resolved, any tracked objects that were automatically allocated during execution will be released.
PowerPoint.run(objects, batch)	Executes a batch script that performs actions on the PowerPoint object model, using the RequestContext of previously-created API objects.

Function Details

PowerPoint.createPresentation(base64File)

Creates and opens a new presentation. Optionally, the presentation can be pre-populated with a Base64-encoded .pptx file.

[ API set: PowerPointApi 1.1 ]

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

Parameters

base64File

string

Optional. The Base64-encoded .pptx file. The default value is null.

Returns

Promise<void>

Examples

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)

Executes a batch script that performs actions on the PowerPoint object model, using a new RequestContext. When the promise is resolved, any tracked objects that were automatically allocated during execution will be released.

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

Parameters

batch

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

A function that takes in a RequestContext and returns a promise (typically, just the result of "context.sync()"). The context parameter facilitates requests to the PowerPoint application. Since the Office add-in and the PowerPoint application run in two different processes, the RequestContext is required to get access to the PowerPoint object model from the add-in.

Returns

OfficeExtension.IPromise<T>

PowerPoint.run(object, batch)

Executes a batch script that performs actions on the PowerPoint object model, using the RequestContext of a previously-created API object. When the promise is resolved, any tracked objects that were automatically allocated during execution will be released.

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

Parameters

object

OfficeExtension.ClientObject

A previously-created API object. The batch will use the same RequestContext as the passed-in object, which means that any changes applied to the object will be picked up by "context.sync()".

batch

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

A function that takes in a RequestContext and returns a promise (typically, just the result of "context.sync()"). The context parameter facilitates requests to the PowerPoint application. Since the Office add-in and the PowerPoint application run in two different processes, the RequestContext is required to get access to the PowerPoint object model from the add-in.

Returns

OfficeExtension.IPromise<T>

PowerPoint.run(objects, batch)

Executes a batch script that performs actions on the PowerPoint object model, using the RequestContext of previously-created API objects.

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

Parameters

objects

OfficeExtension.ClientObject[]

An array of previously-created API objects. The array will be validated to make sure that all of the objects share the same context. The batch will use this shared RequestContext, which means that any changes applied to these objects will be picked up by "context.sync()".

batch

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

A function that takes in a RequestContext and returns a promise (typically, just the result of "context.sync()"). The context parameter facilitates requests to the PowerPoint application. Since the Office add-in and the PowerPoint application run in two different processes, the RequestContext is required to get access to the PowerPoint object model from the add-in.

Returns

OfficeExtension.IPromise<T>