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.
| Conjunto de requisitos | Office na Web | Office no Windows
|
Office no Windows
|
Office no Mac | Office no iPad |
|---|---|---|---|---|---|
| Visualização | Utilize a versão mais recente do Office para experimentar as APIs de pré-visualização (poderá ter de aderir ao programa Microsoft 365 Insider). | ||||
| PowerPointApi 1.6 | Com suporte | Versão 2410 (Compilação 18129.20030) | Não disponível | Versão 16.90 (24101387) | Não disponível |
| PowerPointApi 1.5 | Com suporte | Versão 2208 (Compilação 15601.20230) | Office 2024: Versão 2208 (Compilação 15601.20230) | Versão 16.64 (22080400) | Não disponível |
| PowerPointApi 1.4 | Com suporte | Versão 2207 (Compilação 15330.20122) | Office 2024: Versão 2207 (Compilação 15330.20122) | Versão 16.62 (22061100) | Não disponível |
| PowerPointApi 1.3 | Com suporte | Versão 2111 (build 14701.20060) | Office 2024: Versão 2111 (Compilação 14701.20060) | Versão 16.55 (21111400) | Não disponível |
| PowerPointApi 1.2 | Com suporte | Versão 2011 (Compilação 13426.20184) | Office 2021: Versão 2011 (Compilação 13426.20184) | Versão 16.43 (20110804) | Não disponível |
| PowerPointApi 1.1 | Com suporte | Versão 1810 (Build 11001.20074) | Office 2021: Versão 1810 (Compilação 11001.20074) | Versão 16.19 (18110915) | Versão 2.17 |
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 obter e gerir hiperligações existentes 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).
PowerPoint JavaScript API 1.6
A API JavaScript 1.6 do PowerPoint inclui APIs para selecionar diapositivos, intervalos de texto e formas nas apresentações. Para obter mais informações, veja PowerPoint JavaScript API requirement set 1.6 (Conjunto de requisitos da API JavaScript do PowerPoint definido como 1.6).
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.