Partager via

Nouveautés de l’API JavaScript 1.4 pour Excel

  • Article

Les ajouts apportés aux API JavaScript pour Excel dans l’ensemble de conditions requises 1.4 sont présentés ci-dessous.

Ajout d’élément nommé et nouvelles propriétés

Nouvelles propriétés :

  • comment
  • scope - Éléments délimités à la feuille de calcul ou au classeur.
  • worksheet - Retourne la feuille de calcul sur laquelle l’élément nommé est limité.

Nouvelles méthodes :

  • add(name: string, reference: Range or string, comment: string) - Ajoute un nouveau nom à la collection de l’étendue donnée.
  • addFormulaLocal(name: string, formula: string, comment: string) - Ajoute un nouveau nom à la collection de l’étendue donnée en utilisant les paramètres régionaux de l’utilisateur pour la formule.

API Settings dans l’espace de noms Excel

L’objet Setting représente une paire clé-valeur d’un paramètre conservé dans le document. La fonctionnalité de Excel.Setting équivaut à Office.Settings, mais utilise la syntaxe d’API par lots plutôt que le modèle de rappel de l’API commune.

Les API incluent getItem() d’obtenir l’entrée de paramètre via la clé et add() d’ajouter la paire de paramètre clé :valeur spécifiée au classeur.

Autres

  • Définissez le nom de la colonne de table.
  • Ajoutez une colonne de table à la fin de la table.
  • Ajoutez plusieurs lignes à une table à la fois.
  • range.getColumnsAfter(count: number) et range.getColumnsBefore(count: number) pour obtenir un certain nombre de colonnes à droite/gauche de l’objet de plage actuel.
  • Méthodes et propriétés *OrNullObject : cette fonctionnalité permet d’obtenir un objet à l’aide d’une clé. Si l’objet n’existe pas, la propriété de l’objet isNullObject retourné aura la valeur true. Cela permet aux développeurs de case activée si un objet existe sans avoir à le gérer via la gestion des exceptions. Une *OrNullObject méthode est disponible sur la plupart des objets de collection.
worksheet.getItemOrNullObject("itemName")

Liste des API

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

Classe Champs Description
BindingCollection getCount() Obtient le nombre de liaisons de la collection.
getItemOrNullObject(id: string) Obtient un objet de liaison par ID.
ChartCollection getCount() Renvoie le nombre de graphiques dans la feuille de calcul.
getItemOrNullObject(name: string) Extrait un graphique à l’aide de son nom.
ChartPointsCollection getCount() Renvoie le nombre de points de graphique dans la série.
ChartSeriesCollection getCount() Renvoie le nombre de séries de la collection.
NamedItem comment Spécifie le commentaire associé à ce nom.
delete() Supprime le nom donné.
getRangeOrNullObject() Renvoie l’objet de plage qui est associé au nom.
étendue Spécifie si le nom est limité au classeur ou à une feuille de calcul spécifique.
worksheet Renvoie la feuille de calcul dans laquelle est inclus l’élément nommé.
worksheetOrNullObject Retourne la feuille de calcul dans laquelle l’élément nommé est limité.
NamedItemCollection add(name : string, reference : Range | string, comment ?: string) Ajoute un nouveau nom à la collection de l’étendue donnée.
addFormulaLocal(name : string, formula : string, comment ?: string) Ajoute un nouveau nom à la collection de l’étendue donnée à l’aide des paramètres régionaux de l’utilisateur pour la formule.
getCount() Obtient le nombre d’éléments nommés dans la collection.
getItemOrNullObject(name: string) Obtient un NamedItem objet à l’aide de son nom.
PivotTableCollection getCount() Obtient le nombre de tableaux croisés dynamiques de la collection.
getItemOrNullObject(name: string) Obtient un tableau croisé dynamique par nom.
Range getIntersectionOrNullObject(anotherRange : Range | string) Obtient l’objet de plage qui représente l’intersection rectangulaire des plages données.
getUsedRangeOrNullObject(valuesOnly ?: boolean) Renvoie la plage utilisée d’un objet de plage donné.
RangeViewCollection getCount() Obtient le nombre d’objets RangeView dans la collection.
Paramètre delete() Supprime le paramètre.
key Clé qui représente l’ID du paramètre.
value Représente la valeur stockée pour ce paramètre.
SettingCollection add(key : string, value : string | number | boolean | Date | any[] | any) Définit ou ajoute le paramètre spécifié dans le classeur.
getCount() Obtient le nombre de paramètres dans la collection.
getItem(key: string) Obtient une entrée de paramètre via la clé .
getItemOrNullObject(key: string) Obtient une entrée de paramètre via la clé .
items Obtient l’élément enfant chargé dans cette collection de sites.
onSettingsChanged Se produit lorsque les paramètres du document sont modifiés.
SettingsChangedEventArgs paramètres Obtient l’objet Setting qui représente la liaison qui a déclenché l’événement de modification des paramètres
TableCollection getCount() Obtient le nombre de tableaux de la collection.
getItemOrNullObject(key: string) Obtient un tableau à l’aide de son nom ou de son ID.
TableColumnCollection getCount() Obtient le nombre de colonnes dans le tableau.
getItemOrNullObject(key : number | string) Obtient un objet de colonne par son nom ou son ID.
TableRowCollection getCount() Obtient le nombre de lignes dans le tableau.
Classeur paramètres Représente une collection de paramètres associés au classeur.
Feuille de calcul getUsedRangeOrNullObject(valuesOnly ?: boolean) La plage utilisée est la plus petite plage qui englobe toutes les cellules auxquelles une valeur ou un format est affecté.
Noms Collection de noms inclus dans l’étendue de la feuille de calcul active.
WorksheetCollection getCount(visibleOnly ?: boolean) Obtient le nombre de feuilles de calcul dans la collection.
getItemOrNullObject(key: string) Obtient un objet de feuille de calcul à l’aide de son nom ou de son ID.

Voir aussi