Nouveautés d’Excel API JavaScript 1.12

L’ExcelApi 1.12 a amélioré la prise en charge des formules dans les plages en ajoutant des API pour le suivi des tableaux dynamiques et la recherche des précédents directs d’une formule. Elle a également ajouté le contrôle d’API des filtres de tableau croisé dynamique. Des améliorations ont également été apportées aux zones de fonctionnalités des commentaires, des paramètres de culture et des propriétés personnalisées.

Fonctionnalité Description Objets pertinents
Événements de commentaire Ajoute des événements d’ajout, de modification et de suppression à la collection de commentaires. CommentCollection
Paramètres de culture de date et d’heure Donne accès à d’autres paramètres culturels relatifs au formatage de date et d’heure. CultureInfo, NumberFormatInfoApplication
Précédents directs Renvoie les plages utilisées pour évaluer la formule d’une cellule. Range
Filtres croisés dynamiques Applique des filtres basés sur la valeur aux champs d’un tableau croisé dynamique. champ croisé dynamique, filtres croisés dynamiques
Débordement de plage Permet aux compléments de rechercher des plages associées à des résultats de tableaux dynamiques . Range
Propriétés personnalisées au niveau de la feuille de calcul Permet d’étendre l’étendue des propriétés personnalisées au niveau de la feuille de calcul et non au niveau du classeur. WorksheetCustomProperty, WorksheetCustomPropertyCollection

Liste des API

Le tableau suivant répertorie les API dans Excel : Ensemble de conditions requises pour l’API JavaScript 1.12. Pour consulter la documentation de référence sur toutes les API prises en charge par l’ensemble d’exigences de l’API JavaScript Excel 1.12 ou version antérieure, consultez API Excel dans l’ensemble d’exigences 1.12 ou version antérieure.

Classe Champs Description
ChartAxisTitle textOrientation Spécifie l’angle d’orientation du texte pour le titre de l’axe du graphique.
ChartSeries getDimensionValues(dimension : Excel.ChartSeriesDimension) Obtient les valeurs à partir d’une seule dimension de la série de graphiques.
Commentaire contentType Obtient le type de contenu du commentaire.
CommentAddedEventArgs commentDetails Obtient le CommentDetail tableau qui contient l’ID de commentaire et les ID de ses réponses associées.
source Spécifie la source de l’événement.
type Obtient le type de l’événement.
worksheetId Obtient l’ID de la feuille de calcul dans laquelle l’événement s’est produit.
CommentChangedEventArgs changeType Obtient le type de modification qui représente la façon dont l’événement modifié est déclenché.
commentDetails Obtenir le CommentDetail tableau qui contient l’ID de commentaire et les ID de ses réponses associées.
source Spécifie la source de l’événement.
type Obtient le type de l’événement.
worksheetId Obtient l’ID de la feuille de calcul dans laquelle l’événement s’est produit.
CommentCollection onAdded Se produit lorsque les commentaires sont ajoutés.
onChanged Se produit lorsque des commentaires ou des réponses dans une collection de commentaires sont modifiés, y compris lorsque des réponses sont supprimées.
onDeleted Se produit lorsque des commentaires sont supprimés dans la collection de commentaires.
CommentDeletedEventArgs commentDetails Obtient le CommentDetail tableau qui contient l’ID de commentaire et les ID de ses réponses associées.
source Spécifie la source de l’événement.
type Obtient le type de l’événement.
worksheetId Obtient l’ID de la feuille de calcul dans laquelle l’événement s’est produit.
CommentDetail commentId Représente l’ID du commentaire.
replyIds Représente les ID des réponses associées qui appartiennent au commentaire.
CommentReply contentType Type de contenu de la réponse.
CultureInfo datetimeFormat Définit le format culturellement approprié d’affichage de la date et de l’heure.
DatetimeFormatInfo séparateur de date Récupère la chaîne utilisée comme séparateur de date.
longDatePattern Obtient la chaîne de format d’une valeur de date longue.
longTimePattern Récupère la chaîne de format d’une valeur de longue durée.
shortDatePattern Récupère la chaîne de format d’une valeur de date courte.
timeSeparator Récupère la chaîne utilisée comme séparateur de temps.
PivotDateFilter comparateur Le comparateur est la valeur statique à laquelle d’autres valeurs sont comparées.
condition Spécifie la condition du filtre, qui définit les critères de filtrage nécessaires.
Exclusivité Si true, le filtre exclut les éléments qui répondent aux critères.
lowerBound Limite inférieure de la plage pour la condition de between filtre.
upperBound Limite supérieure de la plage pour la condition de between filtre.
Jours entiers Pour equals, before, afteret between les conditions de filtre, indique si les comparaisons doivent être effectuées sous forme de jours entiers.
PivotField applyFilter(filter : Excel.PivotFilters) Définit un ou plusieurs des filtres croisés dynamiques actuels du champ et les applique au champ.
clearAllFilters() Efface tous les critères de tous les filtres du champ.
clearFilter(filterType : Excel.PivotFilterType) Efface tous les critères existants du filtre du champ du type donné (s’il est actuellement appliqué).
getFilters() Récupère tous les filtres actuellement appliqués sur le champ.
isFiltered(filterType ?: Excel.PivotFilterType) Vérifie si des filtres sont appliqués sur le champ.
PivotFilters dateFilter Filtre de date actuellement appliqué du champ croisé dynamique.
labelFilter Filtre d’étiquette actuellement appliqué de Champ croisé dynamique.
manuelFiltre Filtre manuel actuellement appliqué du champ croisé dynamique.
valueFilter Filtre de valeur actuellement appliqué du champ croisé dynamique.
PivotLabelFilter comparateur Le comparateur est la valeur statique à laquelle d’autres valeurs sont comparées.
condition Spécifie la condition du filtre, qui définit les critères de filtrage nécessaires.
Exclusivité Si true, le filtre exclut les éléments qui répondent aux critères.
lowerBound Limite inférieure de la plage pour la condition de between filtre.
substring Sous-chaîne utilisée pour les conditions , beginsWithendsWithet contains filter.
upperBound Limite supérieure de la plage pour la condition de between filtre.
PivotManualFilter selectedItems Liste des éléments sélectionnés à filtrer manuellement.
PivotTable allowMultipleFiltersPerField Spécifie si le tableau croisé dynamique autorise l’application de plusieurs filtres croisés dynamiques sur un champ croisé dynamique donné de la table.
PivotTableScopedCollection getCount() Obtient le nombre de tableaux croisés dynamiques dans la collection.
getFirst() Obtient le premier tableau croisé dynamique de la collection.
getItem(key: string) Obtient un tableau croisé dynamique par nom.
getItemOrNullObject(name: string) Obtient un tableau croisé dynamique par nom.
items Obtient l’élément enfant chargé dans cette collection de sites.
PivotValueFilter comparateur Le comparateur est la valeur statique à laquelle d’autres valeurs sont comparées.
condition Spécifie la condition du filtre, qui définit les critères de filtrage nécessaires.
Exclusivité Si true, le filtre exclut les éléments qui répondent aux critères.
lowerBound Limite inférieure de la plage pour la condition de between filtre.
selectionType Indique si le filtre est destiné aux N éléments supérieurs/inférieurs, aux N pourcentages supérieurs/inférieurs ou aux N éléments supérieurs/inférieurs.
du programme Nombre seuil « N » d’éléments, pourcentage ou somme à filtrer pour une condition de filtre supérieur/inférieur.
upperBound Limite supérieure de la plage pour la condition de between filtre.
value Nom de la « valeur » choisie dans le champ de filtrage.
Range getDirectPrecedents() Renvoie un WorkbookRangeAreas objet qui représente la plage contenant toutes les cellules précédentes directes d’une plage spécifiée dans la même feuille de calcul ou dans plusieurs feuilles de calcul.
getPivotTables(fullyContained ?: boolean) Obtient une collection étendue de tableaux croisés dynamiques qui chevauchent la plage.
getSpillParent() Obtient l’objet de la plage contenant la cellule d’ancrage d’une cellule prise renversée dans.
getSpillParentOrNullObject() Obtient l’objet de plage contenant la cellule d’ancrage pour la cellule dans laquelle elle est déversée.
getSpillingToRange() Obtient l’objet de la plage contenant la plage renversé lorsque appelée sur une cellule d’ancrage.
getSpillingToRangeOrNullObject() Obtient l’objet de la plage contenant la plage renversé lorsque appelée sur une cellule d’ancrage.
hasSpill Représente si toutes les cellules ont une bordure renversée.
numberFormatCategories Représente la catégorie de format de nombre de chaque cellule.
savedAsArray Indique si toutes les cellules sont enregistrées sous la forme d’une formule matricielle.
RangeAreasCollection getCount() Obtient le nombre d’objets RangeAreas dans cette collection.
getItemAt(index: number) Renvoie l’objet en fonction de sa RangeAreas position dans la collection.
items Obtient l’élément enfant chargé dans cette collection de sites.
WorkbookRangeAreas addresses Renvoie un tableau d’adresses de style A1.
Zones Renvoie l’objet RangeAreasCollection .
getRangeAreasBySheet(key : string) Renvoie l’objet en fonction de l’ID RangeAreas de feuille de calcul ou du nom dans la collection.
getRangeAreasOrNullObjectBySheet(key : string) Renvoie l’objet RangeAreas en fonction du nom de la feuille de calcul ou de l’ID de la collection.
plages Renvoie les plages qui composent cet objet dans un RangeCollection objet.
Feuille de calcul propriétés personnalisées Obtient une collection de propriétés personnalisées au niveau de la feuille de calcul.
WorksheetCustomProperty delete() Supprime la propriété personnalisée.
key Obtient la clé de la propriété personnalisée.
value Spécifie la valeur de la propriété personnalisée.
WorksheetCustomPropertyCollection add(key : string, value : string) Ajoute une nouvelle propriété personnalisée qui correspond à la clé fournie.
getCount() Obtient le nombre de propriétés personnalisées dans cette feuille de calcul.
getItem(key: string) Obtient un objet de propriété personnalisé par sa clé, qui ne tient pas compte de la casse.
getItemOrNullObject(key: string) Obtient un objet de propriété personnalisé par sa clé, qui ne tient pas compte de la casse.
items Obtient l’élément enfant chargé dans cette collection de sites.

Voir aussi