Conjuntos de requisitos da API JavaScript do PowerPoint

  • Artigo

Os conjuntos de requisitos são grupos nomeados de membros da API. Os Suplementos do Office usam conjuntos de requisitos especificados no manifesto ou usam uma verificação de tempo de execução para determinar se um aplicativo do Office oferece suporte para as APIs necessárias para um suplemento. Para obter mais informações, confira Versões do Office e conjuntos de requisitos.

A tabela a seguir lista os conjuntos de requisitos do PowerPoint, os aplicativos cliente do Office com suporte e os builds ou versões mínimas para esses aplicativos, quando aplicável.

Conjunto de requisitos Office no Windows
– Assinatura do Microsoft 365
– varejo perpétuo Office 2016 e posterior		 Office no Windows
(perpétuo licenciado por volume)		 Office no Mac Office no iPad Office na Web
Visualização Use a versão mais recente do Office para tentar visualizar APIs (talvez seja necessário ingressar no programa Do Microsoft 365 Insider).
PowerPointApi 1.5 Versão 2208 (Build 15601.20230) Não disponível 16.64.804.0 Não disponível Com suporte
PowerPointApi 1.4 Versão 2207 (Build 15330.20122) Não disponível 16.62 Não disponível Com suporte
PowerPointApi 1.3 Versão 2111 (build 14701.20060) Não disponível 16.55 Não disponível Com suporte
PowerPointApi 1.2 Versão 2011 (Compilação 13426.20184) Office 2021: Versão 2011 (Build 13426.20184) 16.43 Não disponível Com suporte
PowerPointApi 1.1 Versão 1810 (Build 11001.20074) Office 2021: Versão 1810 (Build 11001.20074) 16.19 2.17 Com suporte

Versões do Office e números de build

Para saber mais sobre as versões do Office e os números de build, confira:

API JavaScript do PowerPoint 1.1

O PowerPoint JavaScript API 1.1 contém uma única API para criar uma nova apresentação. Para obter detalhes sobre a API, confira Criar uma apresentação.

API JavaScript do PowerPoint 1.2

A API JavaScript do PowerPoint 1.2 adiciona suporte para inserir slides de outra apresentação do PowerPoint na apresentação atual e para excluir slides. Para obter detalhes sobre as APIs, consulte Inserir e excluir slides em uma apresentação do PowerPoint.

API JavaScript do PowerPoint 1.3

A API JavaScript do PowerPoint 1.3 adiciona suporte adicional para adicionar e excluir slides. Ele também permite que os suplementos apliquem marcas personalizadas de metadados. Para obter detalhes sobre as APIs, confira Adicionar e excluir slides no PowerPoint e Usar marcas personalizadas para apresentações, slides e formas no PowerPoint.

API JavaScript do PowerPoint 1.4

A API JavaScript do PowerPoint 1.4 adiciona suporte adicional para adicionar, mover, dimensionar, formatar e excluir formas. Para obter mais informações sobre como usar essas APIs, consulte Trabalhando com formas.

API JavaScript do PowerPoint 1.5

A API JavaScript do PowerPoint 1.5 inclui APIs para selecionar slides, intervalos de texto e formas dentro das apresentações. Para obter mais informações, confira o conjunto de requisitos da API JavaScript do PowerPoint 1.5.

Como usar os conjuntos de requisitos do PowerPoint em tempo de execução e no manifesto

Observação

Esta seção pressupõe que você esteja familiarizado com a visão geral dos conjuntos de requisitos em Versões e conjuntos de requisitos do Office e Especificar aplicativos do Office e requisitos de API.

Os conjuntos de requisitos são grupos nomeados de membros da API. Um Suplemento do Office pode executar uma verificação de tempo de execução ou usar conjuntos de requisitos especificados no manifesto para determinar se um aplicativo do Office dá suporte às APIs necessárias ao suplemento.

Verificando o suporte ao conjunto de requisitos no tempo de execução

O exemplo de código a seguir mostra como determinar se o aplicativo do Office, onde o suplemento está em execução, dá suporte ao conjunto de requisitos da API especificado.

if (Office.context.requirements.isSetSupported('PowerPointApi', '1.1')) {
  // Perform actions.
} else {
  // Provide alternate flow/logic.
}

Definindo o suporte ao conjunto de requisitos no manifesto

Você pode usar o elemento Requirements no manifesto do suplemento para especificar os conjuntos de requisitos mínimos e/ou os métodos de API exigidos pelo suplemento para ser ativado. Se o aplicativo ou plataforma do Office não suportar os conjuntos de requisitos ou métodos de API que são especificados no elemento Requirements do manifesto, o suplemento não será executado nesse aplicativo ou plataforma e não será exibido no lista de suplementos que são mostrados em Meus suplementos. Se o seu suplemento requer um conjunto de requisitos específico para funcionalidade total, mas pode fornecer valor até mesmo para usuários em plataformas que não oferecem suporte ao conjunto de requisitos, recomendamos que você verifique o suporte ao requisito no tempo de execução conforme descrito acima, em vez de definir o suporte ao conjunto de requisitos no manifesto.

O exemplo de código a seguir mostra o elemento Requirements em um manifesto de suplemento que especifica que o suplemento deve ser carregado em todos os aplicativos do cliente do Office que oferecem suporte ao conjunto de requisitos da versão 1.1 ou superior do PowerPointApi.

<Requirements>
   <Sets DefaultMinVersion="1.1">
      <Set Name="PowerPointApi" MinVersion="1.1"/>
   </Sets>
</Requirements>

Conjuntos de requisitos da API comum do Office

A maior parte da funcionalidade do suplemento do PowerPoint vem do conjunto de APIs comuns. Para saber mais sobre conjuntos de requisitos comuns da API, confira Conjuntos de requisitos comuns da API do Office.

Confira também