Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
L’API JavaScript PowerPoint permet à votre complément de lire et de modifier des présentations, des diapositives, des formes, du texte et des tableaux. Cet article présente les modèles d’objet que vous utilisez et les objets clés que vous utilisez pour créer des compléments PowerPoint.
API Office.js pour PowerPoint
Un complément PowerPoint interagit avec des objets dans PowerPoint à l’aide de l’API JavaScript Office. Cela inclut deux modèles objet JavaScript :
API JavaScript PowerPoint : l’API JavaScript powerPoint fournit des objets fortement typés qui fonctionnent avec la présentation, les diapositives, les tableaux, les formes, la mise en forme, etc. Pour en savoir plus sur la nature asynchrone des API PowerPoint et sur leur fonctionnement avec la présentation, consultez Utilisation du modèle d’API spécifique à l’application.
API courantes : l’API commune donne accès à des fonctionnalités telles que l’interface utilisateur, les boîtes de dialogue et les paramètres client qui sont communs à plusieurs applications Office. Pour plus d’informations sur les API communes, voir le Modèle d’objet API JavaScript communes.
Bien que vous utilisiez probablement l’API JavaScript PowerPoint pour développer la majorité des fonctionnalités des compléments qui ciblent PowerPoint, vous utiliserez également des objets dans l’API commune. Par exemple :
-
Office.Context : l’objet
Office.Contextreprésente l’environnement d’exécution du complément et donne accès aux objets clés de l’API. Il se compose de détails de configuration de présentation tels quecontentLanguageetofficeThemeet fournit également des informations sur l’environnement d’exécution du complément, commehostetplatform. En outre, il fournit larequirements.isSetSupported()méthode , que vous pouvez utiliser pour case activée si un ensemble de conditions requises spécifié est pris en charge par l’application PowerPoint où le complément s’exécute. -
Office.Document : l’objet
Office.Documentfournit lagetFileAsync()méthode que vous pouvez utiliser pour télécharger le fichier PowerPoint sur lequel le complément est en cours d’exécution. Il fournit également lagetActiveViewAsync()méthode, que vous pouvez utiliser pour case activée si la présentation est en mode « lecture » ou « modification ». « modifier » correspond à l’un des affichages dans lesquels vous pouvez modifier des diapositives : Normal, Trieuse de diapositives ou Mode Plan. « read » correspond au diaporama ou au mode Lecture.
Modèle objet spécifique à PowerPoint
Pour comprendre les API PowerPoint, vous devez comprendre comment les composants clés d’une présentation sont liés les uns aux autres.
- La présentation contient des diapositives et des entités au niveau de la présentation, telles que des paramètres et des parties XML personnalisées.
- Une diapositive contient du contenu tel que des formes, du texte et des tableaux.
- Une disposition détermine la façon dont le contenu d’une diapositive est organisé et affiché.
Le tableau suivant répertorie les objets clés dans l’API JavaScript PowerPoint.
| Objet | Description |
|---|---|
| Presentation | Objet de niveau supérieur. Permet d’accéder aux diapositives, aux étiquettes et aux paramètres à l’échelle de la présentation. |
| Slide | Une seule diapositive. Contient des formes et fait référence à sa disposition. |
| SlideCollection | Collection de diapositives dans la présentation. |
| Forme | Forme d’une diapositive, telle qu’une zone de texte, une image, un trait ou une forme géométrique. |
| TextRange | Texte d’une forme. Utilisez-la pour lire et modifier du texte. |
| SlideLayout | Disposition qui détermine la façon dont le contenu d’une diapositive est organisé. |
| SlideMaster | Master qui définit la mise en forme par défaut et les dispositions disponibles. |
Pour obtenir l’ensemble complet des objets pris en charge par l’API JavaScript PowerPoint, consultez API JavaScript PowerPoint.
Voir aussi
Collaborer avec nous sur GitHub
La source de ce contenu se trouve sur GitHub, où vous pouvez également créer et examiner les problèmes et les demandes de tirage. Pour plus d’informations, consultez notre guide du contributeur.