Séries de conditions requises de l’API JavaScript pour PowerPoint

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

Le tableau suivant répertorie les ensembles de conditions requises PowerPoint, 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
- vente au détail d’Office 2016 et versions ultérieures		 Office pour Windows
(licence en volume perpétuelle)		 Office sur Mac Office sur iPad Office sur le web
Aperçu Utilisez la dernière version d’Office pour essayer les API en préversion (vous devrez peut-être rejoindre le programme Microsoft 365 Insider).
PowerPointApi 1.5 Version 2208 (build 15601.20230) Non disponible 16.64.804.0 Non disponible Pris en charge
PowerPointApi 1.4 Version 2207 (build 15330.20122) Non disponible 16.62 Non disponible Pris en charge
PowerPointApi 1.3 Version 2111 (build 14701.20060) Non disponible 16.55 Non disponible Pris en charge
PowerPointApi 1.2 Version 2011 (build 13426.20184) Office 2021 : version 2011 (build 13426.20184) 16.43 Non disponible Pris en charge
PowerPointApi 1.1 Version 1810 (build 11001.20074) Office 2021 : Version 1810 (build 11001.20074) 16.19 2.17 Pris en charge

Numéros de version et de build d’Office

Pour plus d’informations sur les versions et les numéros de build d’Office, voir :

API JavaScript pour PowerPoint 1.1

L’API JavaScript PowerPoint 1.1 inclut une seule API pour créer une nouvelle présentation. Pour plus d’informations sur l’API, consultez Créer une présentation.

API JavaScript pour PowerPoint 1.2

API JavaScript PowerPoint 1.2 ajoute la prise en charge de l’insertion de diapositives à partir d’une autre présentation PowerPoint dans la présentation actuelle et de la suppression de diapositives. Pour plus d’informations sur les API, consultez Insérer et supprimer des diapositives dans une présentation PowerPoint.

API JavaScript PowerPoint 1.3

L’API JavaScript PowerPoint 1.3 ajoute une prise en charge supplémentaire pour l’ajout et la suppression de diapositives. Il permet également aux compléments d’appliquer des balises de métadonnées personnalisées. Pour plus d’informations sur les API, consultez Ajouter et supprimer des diapositives dans PowerPoint et Utiliser des balises personnalisées pour les présentations, les diapositives et les formes dans PowerPoint.

API JavaScript PowerPoint 1.4

L’API JavaScript PowerPoint 1.4 ajoute une prise en charge supplémentaire de l’ajout, du déplacement, du dimensionnement, de la mise en forme et de la suppression de formes. Pour plus d’informations sur l’utilisation de ces API, consultez Utilisation des formes.

API JavaScript PowerPoint 1.5

L’API JavaScript PowerPoint 1.5 inclut des API permettant de sélectionner des diapositives, des plages de texte et des formes dans des présentations. Pour plus d’informations, consultez l’ensemble de conditions requises de l’API JavaScript PowerPoint 1.5.

Utiliser les conditions requises PowerPoint au moment de l’exécution et dans le manifeste

Remarque

Cette section suppose que vous êtes familiarisé avec les rubriques Versions d’Office et ensembles de conditions requises et Spécifier les applications Office et les exigences de l’API.

Les ensembles de conditions requises sont des groupes nommés de membres d’API. Le complément Office peut effectuer une vérification à l’exécution ou utiliser des ensembles de conditions requises spécifiés dans le manifeste pour déterminer si une application Office prend en charge les API requises par le complément.

Vérification de la prise en charge de l’ensemble de conditions requises à l’exécution

L’exemple de code suivant montre comment déterminer si l’application Office dans laquelle le complément est en cours d’exécution prend en charge l’ensemble spécifié de conditions requises pour l’API.

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

Définition de la prise en charge de l’ensemble de conditions requises dans le manifeste

Vous pouvez utiliser l’élément Requirements dans le manifeste de complément pour spécifier les ensembles de conditions requises minimales et/ou les méthodes d’API que votre complément doit activer. Si la plateforme ou l’application Office ne prend pas en charge les ensembles de conditions requises ou les méthodes d’API spécifiées dans l’élément Requirements du manifeste, le complément ne s’exécute pas dans cette application ou plateforme et ne s’affiche pas dans la liste de compléments dans Mes compléments.Si votre complément requiert une configuration spécifique pour les fonctionnalités complètes, mais qu’il peut fournir une valeur même pour les utilisateurs sur les plateformes qui ne prennent pas en charge la condition requise, nous vous recommandons de vérifier la prise en charge des exigences au moment de l’exécution, comme décrit ci-dessus, au lieu de définir la prise en charge de la condition requise dans le manifeste.

L’exemple de code suivant montre l’élément Requirements dans un manifeste indiquant que le complément doit être chargé dans toutes les applications clientes Office prenant en charge l’ensemble de conditions requises PowerPointApi version 1.1 ou ultérieure.

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

Séries de conditions requises des API communes pour Office

La plupart des fonctionnalités du complément PowerPoint proviennent de l’ensemble d’API communes. Pour plus d’informations sur les ensembles de conditions requises des API communes, voir Ensembles de conditions requises des API communes pour Office.

Voir aussi