Conjuntos de requisitos da API JavaScript do PowerPoint

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, consulte Versões do Office e conjuntos de requisitos.

A tabela seguinte lista os conjuntos de requisitos do PowerPoint, as aplicações cliente do Office suportadas e as versões ou compilações mínimas para essas aplicações, quando aplicável.

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:

• Números de versão e compilação de lançamentos de canais de atualização para clientes do Microsoft 365
• Qual versão do Office estou usando?

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 1.4 do PowerPoint

A API JavaScript 1.4 do PowerPoint adiciona suporte adicional para adicionar, mover, dimensionar, formatar e eliminar formas. Para obter mais informações sobre como utilizar estas APIs, veja Trabalhar com formas.

PowerPoint JavaScript API 1.5

A API JavaScript 1.5 do PowerPoint inclui APIs para selecionar diapositivos, intervalos de texto e formas em apresentações. Para obter mais informações, veja PowerPoint JavaScript API requirement set 1.5 (Conjunto de requisitos da API JavaScript do PowerPoint definido como 1.5).

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

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

• Documentação de Referência da API JavaScript do PowerPoint
• Versões do Office e conjuntos de requisitos
• Especificar requisitos da API e de aplicativos do Office
• Manifesto de Suplementos do Office