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.
Les nouvelles API JavaScript PowerPoint sont introduites pour la première fois en mode « aperçu » et font ensuite partie d’un ensemble de conditions requises spécifiques et numérotées une fois que des tests suffisants ont eu lieu et que les commentaires des utilisateurs ont été acquis.
Remarque
L’aperçu API peut être modifiés et n’est pas destinés à utiliser dans un environnement de production. Nous vous recommandons de les tester uniquement dans les environnements de test et de développement. N’utilisez pas un aperçu d’API dans un environnement de production ou dans les documents commerciaux importants.
Pour utiliser les API disponibles en préversion :
- Vous devez utiliser la version d’évaluation de la bibliothèque d’API JavaScript Office à partir du réseau de distribution de contenu (CDN)Office.js. Le fichier de définition de type pour la compilation et la IntelliSense TypeScript se trouve aux CDN et DefinitelyTyped. Vous pouvez installer ces types avec
npm install --save-dev @types/office-js-preview(veillez à supprimer les types si@types/office-jsvous les avez déjà installés). - Vous devrez peut-être rejoindre le programme Microsoft 365 Insider pour accéder aux versions plus récentes d’Office.
Liste des API
Le tableau suivant répertorie les API JavaScript PowerPoint actuellement en préversion. Pour obtenir la liste complète de toutes les API JavaScript PowerPoint (y compris les API d’aperçu et les API publiées précédemment), voir toutes les API JavaScript PowerPoint.
| Classe | Champs | Description |
|---|---|---|
| AddSlideOptions | index | Spécifie l’index de base 0 auquel la nouvelle diapositive doit être insérée. |
| Graphique | convertToShape() | |
| shape | Renvoie l’objet Shape associé au graphique. |
|
| Options d’ajout d’images | height | Spécifie la hauteur, en points, de l’image. |
| left | Spécifie la distance, en points, entre le côté gauche de l’image et le côté gauche de la diapositive. | |
| top | Spécifie la distance, en points, entre le bord supérieur de l’image et le bord supérieur de la diapositive. | |
| width | Spécifie la largeur, en points, de l’image. | |
| Presentation | getActiveSlideOrNullObject() | Renvoie la diapositive PowerPoint.Slide active actuelle qui est visible dans la zone d’édition. |
| onSlideSelectionChanged | Se produit lorsque la sélection de diapositives dans la présentation change. | |
| sensitivityLabel | Renvoie l’étiquette de confidentialité de la présentation. | |
| SensitivityLabel | getCurrentOrNullObject() | Obtient pour l’utilisateur les informations d’étiquette actuelles qui existent sur la présentation. |
| tryToUpdate(labelId : string) | Tente de mettre à jour l’étiquette de confidentialité fournie sur la présentation pour l’utilisateur. | |
| SensitivityLabelAbacAttribute | displayName | Obtient le nom complet de l’attribut ABAC. |
| displayOrder | Obtient l’ordre recommandé de cet attribut ABAC lorsqu’il est affiché à un utilisateur. | |
| isActive | Récupère si cet attribut ABAC est actif. | |
| isMultiValued | Indique si plusieurs valeurs peuvent être sélectionnées pour cet attribut ABAC. | |
| values | Obtient les valeurs sélectionnables pour cet attribut ABAC. | |
| SensitivityLabelAbacAttributeValue | displayName | Obtient le nom d’affichage de la valeur de l’attribut ABAC. |
| displayOrder | Obtient l’ordre recommandé de cette valeur ABAC dans son attribut lorsqu’elle est affichée à un utilisateur. | |
| id | Obtient l’identificateur unique de la valeur de l’attribut ABAC. | |
| isActive | Détermine si la valeur de cet attribut ABAC est active. | |
| SensitivityLabelDetails | abacAttributeValues | Obtient les valeurs d’attribut de contrôle d’accès basé sur des attributs (ABAC) actuellement appliquées à cette étiquette de confidentialité. |
| les enfants | Obtient les sous-étiquettes de l’étiquette de confidentialité. | |
| color | Récupère la couleur de l’étiquette de confidentialité. | |
| id | Obtient l’ID unique de l’étiquette de confidentialité. | |
| isAbacAttributesRequired | Indique si les sélections d’attributs ABAC sont requises pour appliquer cette étiquette. | |
| isAbacEnabled | Indique si cette étiquette est activée pour le contrôle d’accès basé sur des attributs (ABAC). | |
| isEnabled | Obtient une valeur indiquant si l’étiquette est activée. | |
| name | Récupère le nom de l’étiquette de confidentialité. | |
| order | Obtient la priorité de l’étiquette de confidentialité, avec 0 comme priorité la plus basse. | |
| protectionType | Obtient une valeur indiquant le type de protection fourni par cette étiquette. | |
| siteId | Obtient l’ID unique du client auquel appartient l’étiquette de confidentialité. | |
| info-bulle | Obtient la description de l’étiquette de confidentialité. | |
| SensitivityLabelDetailsCollection | getCount() | Obtient le nombre d’objets PowerPoint.SensitivityLabelDetails dans cette collection. |
| getItem(id: string) | Obtient l’objet spécifié SensitivityLabelDetails dans cette collection. |
|
| getItemAt(index: number) | Obtient l’objet SensitivityLabelDetails à l’index spécifié dans cette collection. |
|
| getItemOrNullObject(id: string) | Obtient l’objet spécifié SensitivityLabelDetails dans cette collection. |
|
| items | Obtient l’élément enfant chargé dans cette collection de sites. | |
| SensitivityLabelsCatalog | getAttributes() | Obtient les attributs de contrôle d’accès basé sur des attributs (ABAC) disponibles pour l’utilisateur actuel. |
| getLabelingCapability | Détermine si le catalogue d’étiquettes de confidentialité est activé dans PowerPoint. | |
| getLabels() | Obtient les étiquettes de confidentialité disponibles pour l’utilisateur actuel. | |
| Forme | getGraphicOrNullObject() | Renvoie un objet PowerPoint.Graphic si cette forme est un ShapeType.graphic. |
| ShapeCollection | addPicture(base64EncodedImage : string, options ?: PowerPoint.PictureAddOptions) | Ajoute une image à la diapositive. |
| SlideLayout | delete() | Supprime la disposition de diapositive de la présentation. |
| SlideMaster | delete() | Supprime la master diapositive et toutes les mises en page enfants de la présentation. |
| SlideSelectionChangedEventArgs | id de diapositive | Obtient le tableau des ID des diapositives actuellement sélectionnées. |