powerpoint package

Clases

PowerPoint.Application
PowerPoint.Presentation
PowerPoint.RequestContext	El objeto RequestContext facilita las solicitudes a la aplicación de PowerPoint. Dado que el complemento de Office y la aplicación de PowerPoint se ejecutan en dos procesos diferentes, el contexto de solicitud es necesario para obtener acceso al modelo de objetos de PowerPoint desde el complemento.
PowerPoint.Shape	Representa una sola forma en la diapositiva.
PowerPoint.ShapeCollection	Representa la colección de formas.
PowerPoint.Slide	Representa una sola diapositiva de una presentación.
PowerPoint.SlideCollection	Representa la colección de diapositivas de la presentación.
PowerPoint.SlideLayout	Representa el diseño de una diapositiva.
PowerPoint.SlideLayoutCollection	Representa la colección de diseños que proporciona el patrón de diapositivas para las diapositivas.
PowerPoint.SlideMaster	Representa el patrón de diapositivas de una diapositiva.
PowerPoint.SlideMasterCollection	Representa la colección de patrones de diapositivas de la presentación.
PowerPoint.Tag	Representa una sola etiqueta en la diapositiva.
PowerPoint.TagCollection	Representa la colección de etiquetas.

Interfaces

PowerPoint.AddSlideOptions	Representa las opciones disponibles al agregar una nueva diapositiva.
PowerPoint.InsertSlideOptions	Representa las opciones disponibles al insertar diapositivas.
PowerPoint.Interfaces.BulletFormatData	Interfaz que describe los datos devueltos mediante una llamada a bulletFormat.toJSON().
PowerPoint.Interfaces.BulletFormatUpdateData	Interfaz para actualizar datos en el BulletFormat objeto , para su uso en bulletFormat.set({ ... }).
PowerPoint.Interfaces.CollectionLoadOptions	Proporciona formas de cargar las propiedades de solo un subconjunto de miembros de una colección.
PowerPoint.Interfaces.HyperlinkCollectionData	Interfaz que describe los datos devueltos mediante una llamada a hyperlinkCollection.toJSON().
PowerPoint.Interfaces.HyperlinkCollectionUpdateData	Interfaz para actualizar datos en el HyperlinkCollection objeto , para su uso en hyperlinkCollection.set({ ... }).
PowerPoint.Interfaces.HyperlinkData	Interfaz que describe los datos devueltos mediante una llamada a hyperlink.toJSON().
PowerPoint.Interfaces.HyperlinkUpdateData	Interfaz para actualizar datos en el Hyperlink objeto , para su uso en hyperlink.set({ ... }).
PowerPoint.Interfaces.ParagraphFormatData	Interfaz que describe los datos devueltos mediante una llamada a paragraphFormat.toJSON().
PowerPoint.Interfaces.ParagraphFormatUpdateData	Interfaz para actualizar datos en el ParagraphFormat objeto , para su uso en paragraphFormat.set({ ... }).
PowerPoint.Interfaces.PresentationData	Interfaz que describe los datos devueltos mediante una llamada a presentation.toJSON().
PowerPoint.Interfaces.PresentationLoadOptions
PowerPoint.Interfaces.ShapeCollectionData	Interfaz que describe los datos devueltos mediante una llamada a shapeCollection.toJSON().
PowerPoint.Interfaces.ShapeCollectionLoadOptions	Representa la colección de formas.
PowerPoint.Interfaces.ShapeCollectionUpdateData	Interfaz para actualizar datos en el ShapeCollection objeto , para su uso en shapeCollection.set({ ... }).
PowerPoint.Interfaces.ShapeData	Interfaz que describe los datos devueltos mediante una llamada a shape.toJSON().
PowerPoint.Interfaces.ShapeFillData	Interfaz que describe los datos devueltos mediante una llamada a shapeFill.toJSON().
PowerPoint.Interfaces.ShapeFillUpdateData	Interfaz para actualizar datos en el ShapeFill objeto , para su uso en shapeFill.set({ ... }).
PowerPoint.Interfaces.ShapeFontData	Interfaz que describe los datos devueltos mediante una llamada a shapeFont.toJSON().
PowerPoint.Interfaces.ShapeFontUpdateData	Interfaz para actualizar datos en el ShapeFont objeto , para su uso en shapeFont.set({ ... }).
PowerPoint.Interfaces.ShapeLineFormatData	Interfaz que describe los datos devueltos mediante una llamada a shapeLineFormat.toJSON().
PowerPoint.Interfaces.ShapeLineFormatUpdateData	Interfaz para actualizar datos en el ShapeLineFormat objeto , para su uso en shapeLineFormat.set({ ... }).
PowerPoint.Interfaces.ShapeLoadOptions	Representa una sola forma en la diapositiva.
PowerPoint.Interfaces.ShapeScopedCollectionData	Interfaz que describe los datos devueltos mediante una llamada a shapeScopedCollection.toJSON().
PowerPoint.Interfaces.ShapeScopedCollectionUpdateData	Interfaz para actualizar datos en el ShapeScopedCollection objeto , para su uso en shapeScopedCollection.set({ ... }).
PowerPoint.Interfaces.ShapeUpdateData	Interfaz para actualizar datos en el Shape objeto , para su uso en shape.set({ ... }).
PowerPoint.Interfaces.SlideCollectionData	Interfaz que describe los datos devueltos mediante una llamada a slideCollection.toJSON().
PowerPoint.Interfaces.SlideCollectionLoadOptions	Representa la colección de diapositivas de la presentación.
PowerPoint.Interfaces.SlideCollectionUpdateData	Interfaz para actualizar datos en el SlideCollection objeto , para su uso en slideCollection.set({ ... }).
PowerPoint.Interfaces.SlideData	Interfaz que describe los datos devueltos mediante una llamada a slide.toJSON().
PowerPoint.Interfaces.SlideLayoutCollectionData	Interfaz que describe los datos devueltos mediante una llamada a slideLayoutCollection.toJSON().
PowerPoint.Interfaces.SlideLayoutCollectionLoadOptions	Representa la colección de diseños que proporciona el patrón de diapositivas para las diapositivas.
PowerPoint.Interfaces.SlideLayoutCollectionUpdateData	Interfaz para actualizar datos en el SlideLayoutCollection objeto , para su uso en slideLayoutCollection.set({ ... }).
PowerPoint.Interfaces.SlideLayoutData	Interfaz que describe los datos devueltos mediante una llamada a slideLayout.toJSON().
PowerPoint.Interfaces.SlideLayoutLoadOptions	Representa el diseño de una diapositiva.
PowerPoint.Interfaces.SlideLoadOptions	Representa una sola diapositiva de una presentación.
PowerPoint.Interfaces.SlideMasterCollectionData	Interfaz que describe los datos devueltos mediante una llamada a slideMasterCollection.toJSON().
PowerPoint.Interfaces.SlideMasterCollectionLoadOptions	Representa la colección de patrones de diapositivas de la presentación.
PowerPoint.Interfaces.SlideMasterCollectionUpdateData	Interfaz para actualizar datos en el SlideMasterCollection objeto , para su uso en slideMasterCollection.set({ ... }).
PowerPoint.Interfaces.SlideMasterData	Interfaz que describe los datos devueltos mediante una llamada a slideMaster.toJSON().
PowerPoint.Interfaces.SlideMasterLoadOptions	Representa el patrón de diapositivas de una diapositiva.
PowerPoint.Interfaces.SlideScopedCollectionData	Interfaz que describe los datos devueltos mediante una llamada a slideScopedCollection.toJSON().
PowerPoint.Interfaces.SlideScopedCollectionUpdateData	Interfaz para actualizar datos en el SlideScopedCollection objeto , para su uso en slideScopedCollection.set({ ... }).
PowerPoint.Interfaces.TagCollectionData	Interfaz que describe los datos devueltos mediante una llamada a tagCollection.toJSON().
PowerPoint.Interfaces.TagCollectionLoadOptions	Representa la colección de etiquetas.
PowerPoint.Interfaces.TagCollectionUpdateData	Interfaz para actualizar datos en el TagCollection objeto , para su uso en tagCollection.set({ ... }).
PowerPoint.Interfaces.TagData	Interfaz que describe los datos devueltos mediante una llamada a tag.toJSON().
PowerPoint.Interfaces.TagLoadOptions	Representa una sola etiqueta en la diapositiva.
PowerPoint.Interfaces.TagUpdateData	Interfaz para actualizar datos en el Tag objeto , para su uso en tag.set({ ... }).
PowerPoint.Interfaces.TextFrameData	Interfaz que describe los datos devueltos mediante una llamada a textFrame.toJSON().
PowerPoint.Interfaces.TextFrameUpdateData	Interfaz para actualizar datos en el TextFrame objeto , para su uso en textFrame.set({ ... }).
PowerPoint.Interfaces.TextRangeData	Interfaz que describe los datos devueltos mediante una llamada a textRange.toJSON().
PowerPoint.Interfaces.TextRangeUpdateData	Interfaz para actualizar datos en el TextRange objeto , para su uso en textRange.set({ ... }).

Enumeraciones

PowerPoint.ErrorCodes
PowerPoint.InsertSlideFormatting	Especifica las opciones de formato para cuando se insertan diapositivas.

Funciones

PowerPoint.createPresentation(base64File)	Crea y abre una nueva presentación. Opcionalmente, la presentación se puede rellenar previamente con un archivo de .pptx codificado en Base64. [ Conjunto de API: PowerPointApi 1.1 ]
PowerPoint.run(batch)	Ejecuta un script por lotes que realiza acciones en el modelo de objetos de PowerPoint mediante un nuevo RequestContext. Cuando se resuelve la promesa, se liberarán los objetos de seguimiento que se asignaron automáticamente durante la ejecución.
PowerPoint.run(object, batch)	Ejecuta un script por lotes que realiza acciones en el modelo de objetos de PowerPoint mediante RequestContext de un objeto de API creado anteriormente. Cuando se resuelve la promesa, se liberarán los objetos de seguimiento que se asignaron automáticamente durante la ejecución.
PowerPoint.run(objects, batch)	Ejecuta un script por lotes que realiza acciones en el modelo de objetos de PowerPoint mediante RequestContext de objetos de API creados anteriormente.

Detalles de la función

PowerPoint.createPresentation(base64File)

Crea y abre una nueva presentación. Opcionalmente, la presentación se puede rellenar previamente con un archivo de .pptx codificado en Base64.

[ Conjunto de API: PowerPointApi 1.1 ]

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

Parámetros

base64File

string

Opcional. El archivo .pptx codificado en Base64. El valor predeterminado es null.

Devoluciones

Promise<void>

Ejemplos

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)

Ejecuta un script por lotes que realiza acciones en el modelo de objetos de PowerPoint mediante un nuevo RequestContext. Cuando se resuelve la promesa, se liberarán los objetos de seguimiento que se asignaron automáticamente durante la ejecución.

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

Parámetros

batch

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

Función que toma un RequestContext y devuelve una promesa (normalmente, solo el resultado de "context.sync()"). El parámetro de contexto facilita las solicitudes a la aplicación de PowerPoint. Dado que el complemento de Office y la aplicación de PowerPoint se ejecutan en dos procesos diferentes, RequestContext es necesario para obtener acceso al modelo de objetos de PowerPoint desde el complemento.

Devoluciones

OfficeExtension.IPromise<T>

PowerPoint.run(object, batch)

Ejecuta un script por lotes que realiza acciones en el modelo de objetos de PowerPoint mediante RequestContext de un objeto de API creado anteriormente. Cuando se resuelve la promesa, se liberarán los objetos de seguimiento que se asignaron automáticamente durante la ejecución.

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

Parámetros

object

OfficeExtension.ClientObject

Objeto de API creado anteriormente. El lote usará el mismo RequestContext que el objeto pasado, lo que significa que cualquier cambio aplicado al objeto será recogido por "context.sync()".

batch

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

Función que toma un RequestContext y devuelve una promesa (normalmente, solo el resultado de "context.sync()"). El parámetro de contexto facilita las solicitudes a la aplicación de PowerPoint. Dado que el complemento de Office y la aplicación de PowerPoint se ejecutan en dos procesos diferentes, RequestContext es necesario para obtener acceso al modelo de objetos de PowerPoint desde el complemento.

Devoluciones

OfficeExtension.IPromise<T>

PowerPoint.run(objects, batch)

Ejecuta un script por lotes que realiza acciones en el modelo de objetos de PowerPoint mediante RequestContext de objetos de API creados anteriormente.

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

Parámetros

objects

OfficeExtension.ClientObject[]

Matriz de objetos de API creados anteriormente. La matriz se validará para asegurarse de que todos los objetos comparten el mismo contexto. El lote usará este RequestContext compartido, lo que significa que cualquier cambio aplicado a estos objetos será recogido por "context.sync()".

batch

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

Función que toma un RequestContext y devuelve una promesa (normalmente, solo el resultado de "context.sync()"). El parámetro de contexto facilita las solicitudes a la aplicación de PowerPoint. Dado que el complemento de Office y la aplicación de PowerPoint se ejecutan en dos procesos diferentes, RequestContext es necesario para obtener acceso al modelo de objetos de PowerPoint desde el complemento.

Devoluciones

OfficeExtension.IPromise<T>