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 objeto BulletFormat, 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.ParagraphFormatData	Interfaz que describe los datos devueltos mediante una llamada a paragraphFormat.toJSON().
PowerPoint.Interfaces.ParagraphFormatUpdateData	Interfaz para actualizar datos en el objeto ParagraphFormat, 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 objeto ShapeCollection, 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 objeto ShapeFill, 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 objeto ShapeFont, 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 objeto ShapeLineFormat, 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.ShapeScopedCollectionLoadOptions	Representa una colección de formas.
PowerPoint.Interfaces.ShapeScopedCollectionUpdateData	Interfaz para actualizar datos en el objeto ShapeScopedCollection, para su uso en shapeScopedCollection.set({ ... }).
PowerPoint.Interfaces.ShapeUpdateData	Interfaz para actualizar datos en el objeto Shape, 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 objeto SlideCollection, 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 objeto SlideLayoutCollection, 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 objeto SlideMasterCollection, 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.SlideScopedCollectionLoadOptions	Representa una colección de diapositivas de la presentación.
PowerPoint.Interfaces.SlideScopedCollectionUpdateData	Interfaz para actualizar datos en el objeto SlideScopedCollection, 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 objeto TagCollection, 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 objeto Tag, 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 objeto TextFrame, 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 objeto TextRange, 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 .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 .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>