Modelo de objetos de JavaScript de PowerPoint en complementos de Office

La API de JavaScript de PowerPoint permite al complemento leer y modificar presentaciones, diapositivas, formas, texto y tablas. En este artículo se presentan los modelos de objetos con los que se trabaja y los objetos clave que se usan para compilar complementos de PowerPoint.

API de Office.js para PowerPoint

Un complemento de PowerPoint interactúa con objetos de PowerPoint mediante la API de JavaScript de Office. Esto incluye dos modelos de objetos de JavaScript:

  • API de JavaScript de PowerPoint: la API de JavaScript de PowerPoint proporciona objetos fuertemente tipados que funcionan con la presentación, las diapositivas, las tablas, las formas, el formato, etc. Para obtener información sobre la naturaleza asincrónica de las API de PowerPoint y cómo funcionan con la presentación, consulte Uso del modelo de API específico de la aplicación.

  • API comunes: Common API proporciona acceso a características como la interfaz de usuario, los diálogos y la configuración de cliente que son comunes en varias aplicaciones de Office. Para obtener más información sobre cómo usar la API común, consulte Modelo de objetos de API de JavaScript común.

Aunque es probable que use la API de JavaScript de PowerPoint para desarrollar la mayoría de la funcionalidad de los complementos que tienen como destino PowerPoint, también usará objetos en Common API. Por ejemplo:

  • Office.Context: el Office.Context objeto representa el entorno en tiempo de ejecución del complemento y proporciona acceso a objetos clave de la API. Consta de detalles de configuración de presentación como contentLanguage y officeTheme también proporciona información sobre el entorno en tiempo de ejecución del complemento, como host y platform. Además, proporciona el requirements.isSetSupported() método , que puede usar para comprobar si la aplicación PowerPoint donde se ejecuta el complemento admite un conjunto de requisitos especificado.
  • Office.Document: el Office.Document objeto proporciona el getFileAsync() método , que puede usar para descargar el archivo de PowerPoint donde se ejecuta el complemento. También proporciona el getActiveViewAsync() método , que puede usar para comprobar si la presentación está en una vista de "lectura" o "edición". "editar" corresponde a cualquiera de las vistas en las que se pueden editar diapositivas: Normal, Clasificador de diapositivas o Vista de esquema. "lectura" corresponde a presentación con diapositivas o vista de lectura.

Modelo de objetos específico de PowerPoint

Para comprender las API de PowerPoint, debe comprender cómo se relacionan entre sí los componentes clave de una presentación.

  • La presentación contiene diapositivas y entidades de nivel de presentación, como la configuración y elementos XML personalizados.
  • Una diapositiva contiene contenido como formas, texto y tablas.
  • Un diseño determina cómo se organiza y muestra el contenido de una diapositiva.

En la tabla siguiente se enumeran los objetos clave de la API de JavaScript de PowerPoint.

Objeto Descripción
Presentation Objeto de nivel superior. Proporciona acceso a diapositivas, etiquetas y configuraciones de toda la presentación.
Diapositiva Una sola diapositiva. Contiene formas y referencias a su diseño.
SlideCollection Colección de diapositivas de la presentación.
Shape Forma de una diapositiva, como un cuadro de texto, una imagen, una línea o una forma geométrica.
TextRange Texto dentro de una forma. Úselo para leer y editar texto.
SlideLayout Diseño que determina cómo se organiza el contenido de una diapositiva.
SlideMaster Patrón que define el formato predeterminado y los diseños disponibles.

Para obtener el conjunto completo de objetos admitidos por la API de JavaScript de PowerPoint, consulte API de JavaScript de PowerPoint.

Vea también

  • Last updated on