Ensembles de conditions requises des API ruban

  • Article

Les ensembles de conditions requises sont des groupes nommés de membres d’API. Les compléments Office utilisent les ensembles de conditions requises spécifiés dans le manifeste ou utilisent une vérification de l’exécution pour déterminer si une application Office prend en charge les API requises par le complément. Pour plus d’informations, consultez Versions d’Office et ensembles de conditions requises.

L’ensemble d’API ruban prend en charge le contrôle par programmation du moment où les commandes de complément personnalisées (c’est-à-dire les boutons de ruban personnalisés et les éléments de menu) sont activées et désactivées et lorsque des onglets contextuels apparaissent sur le ruban.

Les compléments Office s’exécutent sur plusieurs versions d’Office. Le tableau suivant répertorie les ensembles de conditions requises de l’API Ruban, les applications clientes Office prises en charge et les builds ou versions minimales pour ces applications, le cas échéant.

Ensemble de conditions requises Office pour Windows
(Abonnement Microsoft 365)		 Office pour Windows
(vente au détail d’Office 2016 ou version ultérieure)		 Office pour Windows
(licence en volume perpétuelle)		 Office sur Mac Office sur iPad Office sur le web Office Online Server
RibbonApi 1.2 Version 2102 (Build 13801.20294) Version 2102 (Build 13801.20294) Office 2021 : Version 2108 (build 14326.20454) 16.53.806.0 Non pris en charge Pris en charge Non pris en charge
RibbonApi 1.1 Voir le support
section		 Version 2006 (Build 13001.20266) Office 2021 : Version 2108 (build 14326.20454) 16.38 Non pris en charge Pris en charge Non pris en charge

Importante

  • Les ensembles de conditions requises RibbonApi sont pris en charge uniquement sur les compléments du volet Office.
  • Les ensembles de conditions requises RibbonApi sont pris en charge pour les compléments de production uniquement dans Excel.
  • RibbonApi 1.1 (et non 1.2) est disponible en préversion dans PowerPoint et Word, mais uniquement dans Office sur Windows (abonnement Microsoft 365) et Office sur Mac. Il est également disponible en préversion dans PowerPoint sur le web. Pour comprendre comment accéder aux API Office.js préversion, consultez Accès à la bibliothèque d’API JavaScript Office.

Prise en charge de la version 1.1 dans Office sur Windows (abonnement Microsoft 365)

La version 1.1 de l’ensemble de conditions requises RibbonApi est prise en charge dans le canal consommateur à partir de la version 2006 (build 13001.20498). Cet ensemble de conditions requises est également pris en charge dans les versions du canal Semi-Annual et du canal entreprise mensuel disponibles depuis le 14 juillet 2020. Les builds minimales prises en charge pour chaque canal sont les suivantes :

Canal Version minimale Build minimale
Canal actuel 2006 13001.20266
Canal Entreprise mensuel 2005 12827.20538
Canal Entreprise mensuel 2004 12730.20602
Canal Entreprise semestriel 2002 12527.20880

Informations supplémentaires

Pour en savoir plus sur les versions, les numéros de build et Office Online Server, voir :

Ensembles de conditions requises des API communes pour Office

Pour plus d’informations sur les ensembles de conditions requises des API communes, voir Ensembles de conditions requises des API communes pour Office.

API Ruban 1.1

L’API Ruban 1.1 est la première version de l’API. Pour plus d’informations sur l’API, voir la rubrique de référence Office.ribbon .

Cet ensemble de conditions requises prend en charge l’activation et la désactivation des commandes de complément. Pour plus d’informations, reportez-vous aux Commandes Activé et Désactivé pour les compléments.

API ruban 1.2

L’API Ribbon 1.2 ajoute la prise en charge des onglets contextuels. Si vous souhaitez en savoir, veuillez consulter la rubrique Créer des onglets contextuels personnalisés dans des compléments Office.

Remarque

L’ensemble de conditions requises RibbonApi 1.2 n’étant pas encore pris en charge dans le manifeste, vous ne devez pas le spécifier dans la section Exigences> du< manifeste.

Voir aussi