Note
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier les répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de changer de répertoire.
Les nouvelles Excel JavaScript APIs introduits dans « Aperçu » et versions ultérieures deviennent partie intégrante d’une exigence spécifique, numérotée définie après que test suffisantes se produit et les commentaires des utilisateurs sont 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 préversion 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 pour@types/office-jssi vous les avez déjà installés). - Vous devrez peut-être rejoindre le programme Microsoft 365 Insider pour accéder à des builds Office plus récentes.
Le tableau suivant fournit un résumé concis des API, tandis que le tableau de liste d’API suivant fournit une liste détaillée.
| Fonctionnalité | Description | Objets pertinents |
|---|---|---|
| Tâches de document | Transformez les commentaires en tâches attribuées aux utilisateurs. | DocumentTask, DocumentTaskChange, DocumentTaskChangeCollection, DocumentTaskCollection |
| Styles de tableau | Fournit un contrôle pour la police, la bordure, la couleur de remplissage et d’autres aspects des styles de tableau. | Tableau, tableau croisé dynamique, segment |
Liste des API
Le tableau suivant répertorie les API JavaScript Excel actuellement en préversion. Pour obtenir la liste complète de toutes les API JavaScript Excel (y compris les API en préversion et les API précédemment publiées), consultez toutes les API JavaScript Excel.
| Classe | Champs | Description |
|---|---|---|
| Application | formatStaleValues | Spécifie si l’option Mettre en forme les valeurs obsolètes dans Options de calcul est activée ou désactivée. |
| AutorunEventCompletedOptions | allowEvent | Spécifie s’il faut autoriser l’événement à continuer. |
| autorunEventType | Spécifie le type d’événement d’exécution automatique à terminer si autorisé. | |
| message | S’il est fourni, spécifie un message d’erreur facultatif si l’événement n’est pas autorisé à se poursuivre. | |
| Base64EncodedImage | data | Chaîne encodée en Base64. |
| type | Type de fichier de l’image encodée en Base64. | |
| Graphique | getDataRange() | Obtient la source de données de l’ensemble du graphique. |
| getDataRangeOrNullObject() | Obtient la source de données de l’ensemble du graphique. | |
| Commentaire | assignTask(assignee : Excel.EmailIdentity) | Affecte la tâche jointe au commentaire à l’utilisateur donné en tant que destinataire. |
| getTask() | Obtient la tâche associée à ce commentaire. | |
| getTaskOrNullObject() | Obtient la tâche associée à ce commentaire. | |
| CommentReply | assignTask(assignee : Excel.EmailIdentity) | Affecte la tâche jointe au commentaire à l’utilisateur donné en tant que seul destinataire. |
| getTask() | Obtient la tâche associée au thread de cette réponse de commentaire. | |
| getTaskOrNullObject() | Obtient la tâche associée au thread de cette réponse de commentaire. | |
| DatetimeFormatInfo | shortDateTimePattern | Obtient la chaîne de format pour une valeur de date et d’heure courte. |
| DocumentTask | assign(assignee : Excel.EmailIdentity) | Ajoute l’utilisateur donné à la liste des personnes associées à la tâche. |
| Cessionnaires | Retourne une collection de personnes assignées de la tâche. | |
| changements | Obtient les enregistrements de modification de la tâche. | |
| comment | Obtient le commentaire associé à la tâche. | |
| completedBy | Obtient l’utilisateur le plus récent à avoir terminé la tâche. | |
| completedDateTime | Obtient la date et l’heure auxquelles la tâche a été terminée. | |
| createdBy | Obtient l’utilisateur qui a créé la tâche. | |
| createdDateTime | Obtient la date et l’heure de création de la tâche. | |
| id | Obtient l’ID de la tâche. | |
| percentComplete | Spécifie le pourcentage d’achèvement de la tâche. | |
| priorité | Spécifie la priorité de la tâche. | |
| startAndDueDateTime | Spécifie la date et l’heure à laquelle la tâche doit démarrer et est arrivée à échéance. | |
| title | Spécifie le titre de la tâche. | |
| unassign(assignee : Excel.EmailIdentity) | Supprime l’utilisateur donné de la liste des ayants droit attachés à la tâche. | |
| unassignAll() | Supprime tous les utilisateurs de la liste des ayants droit attachés à la tâche. | |
| DocumentTaskChange | cessionnaire | Représente l’utilisateur affecté à la tâche pour une assign action de modification, ou l’utilisateur non affecté à la tâche pour une unassign action de modification. |
| changedBy | Représente l’identité de l’utilisateur qui a modifié la tâche. | |
| commentId | Représente l’ID de la réponse au commentaire ou au commentaire auquel la modification de tâche est ancrée. | |
| createdDateTime | Représente la date et l’heure de création de l’enregistrement de modification de tâche. | |
| dueDateTime | Représente la date et l’heure d’échéance de la tâche. | |
| id | GUID unique de la modification de la tâche. | |
| percentComplete | Représente le pourcentage d’achèvement de la tâche. | |
| priorité | Représente la priorité de la tâche. | |
| startDateTime | Représente la date et l’heure de début de la tâche. | |
| title | Représente le titre de la tâche. | |
| type | Représente le type d’action de l’enregistrement de modification de tâche. | |
| undoChangeId | Représente la DocumentTaskChange.id propriété qui a été annulée pour l’action de undo modification. |
|
| DocumentTaskChangeCollection | getCount() | Obtient le nombre d’enregistrements de modification dans la collection pour la tâche. |
| getItemAt(index: number) | Obtient un enregistrement de modification de tâche à l’aide de son index dans la collection. | |
| items | Obtient l’élément enfant chargé dans cette collection de sites. | |
| DocumentTaskCollection | getCount() | Obtient le nombre de tâches dans la collection. |
| getItem(key: string) | Obtient une tâche à l’aide de son ID. | |
| getItemAt(index: number) | Obtient une tâche en fonction de son index dans la collection. | |
| getItemOrNullObject(key: string) | Obtient une tâche à l’aide de son ID. | |
| items | Obtient l’élément enfant chargé dans cette collection de sites. | |
| DocumentTaskSchedule | dueDateTime | Obtient la date et l’heure d’échéance de la tâche. |
| startDateTime | Obtient la date et l’heure de début de la tâche. | |
| EmailIdentity | displayName | Représente le nom d’affichage de l’utilisateur. |
| Représente l’e-mail de l’utilisateur. | ||
| id | Représente l’ID unique de l’utilisateur. | |
| EntityArrayCardLayout | arrayProperty | Représente le nom de la propriété qui contient le tableau affiché dans le carte. |
| columnsToReport | Représente le nombre de colonnes dans lesquelles les revendications carte se trouvent dans le tableau. | |
| displayName | Représente le nom de la propriété qui contient le tableau affiché dans le carte. | |
| firstRowIsHeader | Représente si la première ligne du tableau est traitée comme un en-tête. | |
| disposition | Représente le type de cette disposition. | |
| rowsToReport | Représente le nombre de lignes dans lesquelles les revendications carte se trouvent dans le tableau. | |
| ExternalCodeServiceObjectCellValue | Python_str | Représente la sortie de la str() fonction lorsqu’elle est utilisée sur cet objet. |
| Python_type | Représente le nom de type complet de cet objet. | |
| Python_typeName | Représente le nom de type court de cet objet. | |
| basicType | Représente la valeur qui serait retournée par Range.valueTypes pour une cellule avec cette valeur. |
|
| basicValue | Représente la valeur qui serait retournée par Range.values pour une cellule avec cette valeur. |
|
| language | Représente le langage d’exécution de ce service de code externe. | |
| aperçu | Représente la valeur d’aperçu affichée dans la cellule. | |
| fournisseur | Représente des informations sur le service qui a fourni les données dans ce ExternalCodeServiceObjectCellValue. |
|
| type | Représente le type de cette valeur de cellule. | |
| Identity | displayName | Représente le nom d’affichage de l’utilisateur. |
| id | Représente l’ID unique de l’utilisateur. | |
| LocalImage | getBase64EncodedImageData(cacheUid : string) | Obtient les données d’image encodées en Base64 stockées dans le cache d’images partagées avec l’identificateur unique de cache (UID). |
| LocalImageCellValue | altText | Représente le texte de remplacement utilisé dans les scénarios d’accessibilité pour décrire ce que l’image représente. |
| attribution | Représente les informations d’attribution pour décrire la source et les exigences de licence pour cette image. | |
| basicType | Représente la valeur qui serait retournée par Range.valueTypes pour une cellule avec cette valeur. |
|
| basicValue | Représente la valeur qui serait retournée par Range.values pour une cellule avec cette valeur. |
|
| image | Représente l’image elle-même, mise en cache ou encodée. | |
| fournisseur | Représente des informations qui décrivent l’entité ou la personne qui a fourni l’image. | |
| type | Représente le type de cette valeur de cellule. | |
| LocalImageCellValueCacheId | cachedUid | Représente l’UID de l’image telle qu’elle apparaît dans le cache. |
| NameErrorCellValue | errorSubType | Représente le type de NameErrorCellValue. |
| NamedSheetViewCollection | getItemOrNullObject(key: string) | Obtient une vue de feuille à l’aide de son nom. |
| NotAvailableErrorCellValue | errorSubType | Représente le type de NotAvailableErrorCellValue. |
| PivotLayout | getCell(dataHierarchy : DataPivotHierarchy | string, rowItems : Array<PivotItem | string>, columnItems : Array<PivotItem | string>) | Obtient une cellule unique dans le tableau croisé dynamique basé sur une hiérarchie de données ainsi que les éléments de ligne et de colonne de leurs hiérarchies respectives. |
| pivotStyle | Style appliqué au tableau croisé dynamique. | |
| setStyle(style : string | PivotTableStyle | BuiltInPivotTableStyle) | Définit le style appliqué au tableau croisé dynamique. | |
| PivotTable | autoRefresh | Spécifie si le tableau croisé dynamique s’actualise automatiquement lorsque les données sources changent. |
| PythonErrorCellValue | basicType | Représente la valeur qui serait retournée par Range.valueTypes pour une cellule avec cette valeur. |
| basicValue | Représente la valeur qui serait retournée par Range.values pour une cellule avec cette valeur. |
|
| errorType | Représente le type de ErrorCellValue. |
|
| type | Représente le type de cette valeur de cellule. | |
| Query | delete() | Supprime la requête et la connexion associée. |
| refresh() | Actualise la requête. | |
| QueryCollection | refreshAll() | Actualisez toutes les requêtes. |
| Range | togglePythonMarshalMode(marshalMode ?: Excel.PythonMarshalMode) | Définit le mode de marshaling de Python dans Excel formule =PY. |
| RequestContext | setInvocation(invocation : { invocationId : number isInSyncExecution : boolean }) | |
| ShapeCollection | addLocalImageReference(address : string) | Crée une référence pour l’image locale stockée dans l’adresse de cellule et l’affiche sous la forme d’une forme flottante sur les cellules. |
| addSvg(xml: string) | Crée un graphique de fichiers SVG (SVG) à partir d’une chaîne XML et il est ajouté à la feuille de calcul. | |
| ShapeFont | strikethrough | Spécifie le status barré de la police. |
| Subscript | Spécifie l’indice status de police. | |
| superscript | Spécifie l’exposant status de police. | |
| tintAndShade | Spécifie un double qui éclaircit ou assombrit une couleur pour la police de plage. | |
| Segment | nameInFormula | Spécifie le nom du segment utilisé dans la formule. |
| setStyle(style : string | SlicerStyle | BuiltInSlicerStyle) | Définit le style appliqué au segment. | |
| slicerStyle | Style appliqué au segment. | |
| Tableau | altTextDescription | Spécifie le texte de remplacement pour l’accessibilité. |
| altTextTitle | Spécifie un résumé pour le tableau, tel que celui utilisé par les lecteurs d’écran. | |
| clearStyle() | Modifie le tableau pour utiliser le style de tableau par défaut. | |
| comment | Spécifie un commentaire associé à la table. | |
| isActive | Récupère si la table est actuellement active. | |
| onFiltered | Se produit lorsqu’un filtre est appliqué à une table spécifique. | |
| setStyle(style : string | TableStyle | BuiltInTableStyle) | Définit le style appliqué au tableau. | |
| source | Récupère le type de source de données d’où provient la table. | |
| tableStyle | Style appliqué au tableau. | |
| TableCollection | onFiltered | Se produit lorsqu’un filtre est appliqué à une table d’un classeur ou d’une feuille de calcul. |
| TableFilteredEventArgs | tableId | Obtient l’ID de la table dans laquelle le filtre est appliqué. |
| type | Obtient le type de l’événement. | |
| worksheetId | Obtient l’ID de la feuille de calcul qui contient le tableau. | |
| TimeoutErrorCellValue | basicType | Représente la valeur qui serait retournée par Range.valueTypes pour une cellule avec cette valeur. |
| basicValue | Représente la valeur qui serait retournée par Range.values pour une cellule avec cette valeur. |
|
| errorSubType | Représente le type de TimeoutErrorCellValue. |
|
| errorType | Représente le type de ErrorCellValue. |
|
| type | Représente le type de cette valeur de cellule. | |
| Window | rangeSelection | Obtient la sélection de plage dans la fenêtre. |
| Classeur | autorunEventCompleted(AutorunEventCompletedOptions : Excel.AutorunEventCompletedOptions) | Avertit l’application hôte que le code du complément a fini de s’exécuter dans un événement d’exécution automatique. |
| externalCodeServiceTimeout | Spécifie la durée maximale, en secondes, allouée à une formule qui dépend d’un service de code externe. | |
| localImage | Retourne l’objet LocalImage associé au classeur. |
|
| showPivotFieldList | Spécifie si le volet liste de champs du tableau croisé dynamique s’affiche au niveau du classeur. | |
| tâches | Retourne une collection de tâches présentes dans le classeur. | |
| use1904DateSystem | True si le classeur utilise le calendrier depuis 1904. | |
| Worksheet | onFiltered | Se produit lorsqu’un filtre est appliqué à une feuille de calcul spécifique. |
| tâches | Retourne une collection de tâches présentes dans la feuille de calcul. | |
| WorksheetCollection | addFromBase64(base64File : string, sheetNamesToInsert ?: string[], positionType ?: Excel.WorksheetPositionType, relativeTo ?: Worksheet | string) | Insère les feuilles de calcul spécifiées d’un classeur dans le classeur actif. |
| onFiltered | Se produit lorsqu’un filtre de la feuille de calcul est appliqué dans le classeur. | |
| WorksheetFilteredEventArgs | type | Obtient le type de l’événement. |
| worksheetId | Obtient l’ID de la feuille de calcul dans laquelle le filtre est appliqué. |