Modelo de objeto JavaScript do PowerPoint em Suplementos do Office

A API JavaScript do PowerPoint permite que seu suplemento leia e modifique apresentações, slides, formas, texto e tabelas. Este artigo apresenta os modelos de objeto com os quais você trabalha e os principais objetos usados para criar suplementos do PowerPoint.

APIs Office.js para PowerPoint

Um suplemento do PowerPoint interage com objetos no PowerPoint usando a API JavaScript do Office. Isso inclui dois modelos de objeto JavaScript:

• API JavaScript do PowerPoint: a API JavaScript do PowerPoint fornece objetos fortemente tipados que funcionam com a apresentação, slides, tabelas, formas, formatação e muito mais. Para saber mais sobre a natureza assíncrona das APIs do PowerPoint e como elas funcionam com a apresentação, confira Usando o modelo de API específico do aplicativo.

• APIs comuns: a API comum fornece acesso a recursos, como interface do usuário, caixas de diálogo e configurações de cliente, que são comuns em vários aplicativos do Office. Para obter mais informações sobre como usar a API comum, confira Modelo do objeto do API de JavaScript para Office.

Embora você provavelmente use a API JavaScript do PowerPoint para desenvolver a maioria das funcionalidades em suplementos direcionados ao PowerPoint, também usará objetos na API comum. Por exemplo:

• Office.Context: o Office.Context objeto representa o ambiente de tempo de execução do suplemento e fornece acesso aos principais objetos da API. Ele consiste em detalhes de configuração de apresentação, como contentLanguage e officeTheme e também fornece informações sobre o ambiente de tempo de execução do suplemento, como host e platform. Além disso, ele fornece o requirements.isSetSupported() método, que você pode usar para marcar se um conjunto de requisitos especificado é suportado pelo aplicativo PowerPoint onde o suplemento está sendo executado.
• Office.Document: o Office.Document objeto fornece o getFileAsync() método que você pode usar para baixar o arquivo do PowerPoint em que o suplemento está sendo executado. Ele também fornece o getActiveViewAsync() método, que você pode usar para marcar se a apresentação está em um modo de exibição "lido" ou "editado". "editar" corresponde a qualquer um dos modos de exibição nos quais você pode editar slides: Normal, Classificador de Slides ou Modo de Exibição de Estrutura de Tópicos. "read" corresponde a Apresentação de Slides ou Modo de Exibição de Leitura.

Modelo de objeto específico do PowerPoint

Para entender as APIs do PowerPoint, você deve entender como os principais componentes de uma apresentação estão relacionados entre si.

• A apresentação contém slides e entidades de nível de apresentação, como configurações e partes XML personalizadas.
• Um slide contém conteúdo como formas, texto e tabelas.
• Um layout determina como o conteúdo de um slide é organizado e exibido.

A tabela a seguir lista os principais objetos na API JavaScript do PowerPoint.

Para obter o conjunto completo de objetos compatíveis com a API JavaScript do PowerPoint, consulte API JavaScript do PowerPoint.

Confira também

• Referência da API JavaScript do PowerPoint
• Suplementos do PowerPoint
• Crie o seu primeiro suplemento do PowerPoint
• Tutorial de suplemento do PowerPoint
• Saiba mais sobre o Programa para Desenvolvedores do Microsoft 365