Conjuntos de requisitos comuns da API

  • 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.

O conjunto de API da Faixa de Opções dá suporte ao controle programático de quando comandos de suplemento personalizados (ou seja, botões de faixa de opções personalizados e itens de menu) são habilitados e desabilitados e quando as guias contextuais aparecem na faixa de opções.

Os suplementos do Office executam várias versões do Office. A tabela a seguir lista os conjuntos de requisitos da API da Faixa de Opções, os aplicativos cliente do Office com suporte e as versões mínimas ou builds para os aplicativos quando aplicável.

Conjunto de requisitos Office no Windows
(Assinatura do Microsoft 365)		 Office no Windows
(varejo perpétuo Office 2016 ou posterior)		 Office no Windows
(perpétuo licenciado por volume)		 Office no Mac Office no iPad Office na Web Servidor do Office Online
RibbonApi 1.2 Versão 2102 (Build 13801.20294) Versão 2102 (Build 13801.20294) Office 2021: Versão 2108 (Build 14326.20454) 16.53.806.0 Sem suporte Com suporte Sem suporte
RibbonApi 1.1 Consulte suporte
section		 Versão 2006 (Build 13001.20266) Office 2021: Versão 2108 (Build 14326.20454) 16.38 Sem suporte Com suporte Sem suporte

Importante

  • Os conjuntos de requisitos ribbonApi têm suporte apenas em suplementos do painel de tarefas.
  • Os conjuntos de requisitos do RibbonApi têm suporte apenas para suplementos de produção no Excel.
  • RibbonApi 1.1 (não 1.2) está disponível como uma versão prévia no PowerPoint e Word, mas apenas no Office no Windows (assinatura do Microsoft 365) e no Office no Mac. Ele também está disponível para visualização no PowerPoint na Web. Para entender como acessar Office.js APIs de visualização, consulte Acessando a biblioteca de API JavaScript do Office.

Suporte para a versão 1.1 no Office no Windows (assinatura do Microsoft 365)

A versão 1.1 do conjunto de requisitos RibbonApi tem suporte no Canal do Consumidor da Versão 2006 (Build 13001.20498). Esse conjunto de requisitos também tem suporte nos builds Semi-Annual Channel e Monthly Enterprise Channel disponíveis desde 14 de julho de 2020. Os builds mínimos com suporte para cada canal são os seguintes:

Canal Versão mínima Build mínimo
Canal Atual 2006 13001.20266
Canal Empresarial Mensal 2005 12827.20538
Canal Empresarial Mensal 2004 12730.20602
Canal Empresarial Semestral 2002 12527.20880

Mais informações

Para saber mais sobre versões, números de build e sobre o Servidor do Office Online, confira:

Conjuntos de requisitos da API comum do Office

Para saber mais sobre conjuntos de requisitos comuns da API, confira Conjuntos de requisitos comuns da API do Office.

API da Faixa de Opções 1.1

A API da Faixa de Opções 1.1 é a primeira versão da API. Para obter detalhes sobre a API, consulte o tópico de referência do Office.ribbon .

Esse conjunto de requisitos inclui suporte para habilitar e desabilitar comandos de suplemento. Para obter mais informações, consulte Ativar e Desativar Comandos de Suplemento.

API da Faixa de Opções 1.2

A API da Faixa de Opções 1.2 adiciona suporte para guias contextuais. Para obter mais informações, confira Criar guias contextuais personalizadas em Suplementos do Office.

Observação

O conjunto de requisitos RibbonApi 1.2 ainda não tem suporte no manifesto, portanto, você não deve especifique-o na seção Requisitos> do< manifesto.

Confira também