Nouveautés de l’API JavaScript 1.7 pour Excel

Les fonctionnalités Excel API JavaScript ensemble de conditions 1.7 incluent des API pour les graphiques, événements, feuilles de calcul, plages, propriétés de document, éléments nommés, options de protection et styles.

Personnaliser des graphiques

Avec le nouvel API graphique, vous pouvez créer des types de graphiques supplémentaires, ajouter une série de données à un graphique, définir le titre du graphique, ajouter un titre d’axe, ajouter une unité d’affichage, ajouter une courbe de tendance avec moyenne mobile, modifier une courbe de tendance en ligne, et bien plus encore. Voici quelques exemples.

  • Axe du graphique - obtenir, définir, mettre en forme et supprimer une unité d’axe, une étiquette et un titre dans un graphique.
  • Série de graphique - ajouter, configurer et supprimer une série dans un graphique. Modifier les marqueurs de série, les commandes traçage et le redimensionnement.
  • Courbes de tendance de graphique - ajouter, obtenir et mettre en forme des courbes de tendance dans un graphique.
  • Légende de graphique - mettre en forme la police de légende dans un graphique.
  • Point de graphique - définir la couleur du point de graphique.
  • Sous-chaîne de titre de graphique : obtenir et définir la sous-chaîne de titre d’un graphique.
  • Type de graphique - option pour créer plusieurs types de graphiques.

Événements

Les API Événements pour Excel fournissent un grand nombre de gestionnaires d’événements autorisant votre complément à exécuter automatiquement une fonction désignée lorsqu’un événement spécifique se produit. Vous pouvez créer cette fonction pour effectuer n’importe quelle action nécessaire à votre scénario. Pour une liste des événements qui sont actuellement disponibles, voir Manipuler des Événements à l’aide de l’API JavaScript Excel.

Personnaliser l’apparence de feuilles de calcul et des plages

À l’aide des nouveaux API, vous pouvez personnaliser l’apparence de feuilles de calcul de plusieurs façons :

  • Figer les volets pour conserver certaines lignes ou colonnes visibles lorsque vous faites défiler la feuille de calcul. Par exemple, si la première ligne dans votre feuille de calcul contient des en-têtes, vous pouvez figer cette ligne de sorte que les en-têtes de colonne restent visibles pendant le défilement vers le bas de la feuille de calcul.
  • Modifier la couleur d’onglet de la feuille de calcul.
  • Ajouter des en-têtes de feuille de calcul.

Vous pouvez personnaliser l’apparence des plages de plusieurs façons :

  • Définir le style de cellule pour une plage pour vous assurer que toutes les cellules dans la plage ont une mise en forme cohérente. Un style de cellule est un ensemble défini de caractéristiques de mise en forme, comme les polices et les tailles de police, formats des nombres, bordures de cellule et ombrage de cellule. Utilisez un des styles de cellule intégrés d’Excel ou créer votre propre style de cellule personnalisé.
  • Définit l’orientation du texte pour une plage.
  • Ajouter ou modifier un lien hypertexte sur une plage qui permet d’accéder à un autre emplacement dans le classeur ou à un emplacement externe.

Gérer les propriétés du document

À l’aide des API de propriétés du document, vous pouvez accéder aux propriétés de document intégrées et également créer et gérer les propriétés de document personnalisées pour stocker l’état du classeur et lire le flux de travail et la logique d’entreprise.

Obtenir des feuilles de calcul

À l’aide des API de copie de feuille de calcul , vous pouvez copier les données et le format à partir d’une feuille de calcul dans une nouvelle feuille de calcul au sein du même classeur et réduire la quantité de transfert de données nécessaire.

Gérer les plages en toute simplicité

À l’aide des API de plage différente, vous pouvez effectuer des actions telles qu’obtenir la région environnante, obtenir une plage redimensionnée et bien plus encore. Ces API doivent rendre des tâches telles que la manipulation de plage et l’adressage beaucoup plus efficaces.

De plus :

  • Options de protection de classeur et feuille de calcul : utilisez ces API pour protéger les données dans une feuille de calcul et la structure du classeur.
  • Mettre à jour un élément nommé : utilisez cet API pour mettre à jour un élément nommé.
  • Obtenir la cellule active : utilisez cette API pour obtenir la cellule active d’un classeur.

Liste des API

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

Classe Champs Description
Graphique type de graphique Spécifie le type du graphique.
id L’ID unique du graphique.
showAllFieldButtons Indique si tous les boutons de champ doivent être affichés dans un graphique croisé dynamique.
ChartAreaFormat à la frontière Représente le format de bordure de la zone de graphique, qui inclut la couleur, le style de ligne et l’épaisseur.
ChartAxes getItem(type : Excel.ChartAxisType, group ?: Excel.ChartAxisGroup) Renvoie l’axe spécifique identifié par type et par groupe.
ChartAxis axisGroup Spécifie le groupe de l’axe spécifié.
baseTimeUnit Spécifie l’unité de base pour l’axe des catégories spécifié.
categoryType Spécifie le type d’axe des catégories.
customDisplayUnit Spécifie la valeur de l’unité d’affichage de l’axe personnalisé.
displayUnit Représente l’unité d’affichage de l’axe.
height Spécifie la hauteur, en points, de l’axe du graphique.
left Spécifie la distance, en points, entre le bord gauche de l’axe et la gauche de la zone du graphique.
logBase Spécifie la base du logarithme lors de l’utilisation d’échelles logarithmiques.
majorTickMark Spécifie le type de graduation principale pour l’axe spécifié.
majorTimeUnitScale Spécifie la valeur d’échelle unitaire principale pour l’axe des catégories lorsque la categoryType propriété est définie sur dateAxis.
minorTickMark Spécifie le type de graduation secondaire pour l’axe spécifié.
minorTimeUnitScale Spécifie la valeur de l’échelle unitaire secondaire pour l’axe des catégories lorsque la categoryType propriété est définie sur dateAxis.
reversePlotOrder Spécifie si Excel trace les points de données du dernier au premier.
scaleType Spécifie le type d’échelle de l’axe des valeurs.
setCategoryNames(sourceData : Range) Définit tous les noms de catégorie pour l’axe spécifié.
setCustomDisplayUnit(value : number) Définit l’unité d’affichage axe sur une valeur personnalisée.
showDisplayUnitLabel Indique si l’étiquette de l’unité d’affichage de l’axe est visible.
tickLabelPosition Spécifie la position des étiquettes de graduation sur l'axe spécifié.
tickLabelSpacing Spécifie le nombre de catégories ou de séries entre les étiquettes de graduation.
tickMarkSpacing Spécifie le nombre de catégories ou de séries entre les graduations.
top Spécifie la distance, en points, entre le bord supérieur de l’axe et le haut de la zone du graphique.
type Spécifie le type d’axe.
visible Indique si l’axe est visible.
width Spécifie la largeur, en points, de l’axe du graphique.
ChartBorder color Code couleur HTML qui représente la couleur des bordures dans le graphique.
lineStyle Représente le style de trait de la bordure.
weight Représente l’épaisseur de bordure, en points.
ChartDataLabel position Valeur qui représente la position de l’étiquette de données.
séparateur Chaîne représentant le séparateur utilisé pour les étiquettes de données d’un graphique.
showBubbleSize Indique si la taille de la bulle de l’étiquette de données est visible.
showCategoryName Indique si le nom de la catégorie de l’étiquette de données est visible.
showLegendKey Indique si la légende de l’étiquette de données est visible.
showPercentage Indique si le pourcentage d’étiquette de données est visible.
showSeriesName Indique si le nom de la série d’étiquettes de données est visible.
showValue Indique si la valeur de l’étiquette de données est visible.
ChartFormatString police Représente les attributs de police, tels que le nom de la police, la taille de police et la couleur d’un objet caractères de graphique.
ChartLegend height Indique la hauteur, en points, de la légende sur le graphique.
left Indique la valeur à gauche, en points, de la légende sur le graphique.
legendEntries Représente une collection de legendEntries dans la légende.
showShadow Indique si la légende a une ombre sur le graphique.
top Spécifie le haut d’une légende de graphique.
width Spécifie la largeur, en points, de la légende sur le graphique.
ChartLegendEntry visible Représente la visibilité d’une entrée de légende de graphique.
ChartLegendEntryCollection getCount() Renvoie le nombre d’entrées de légende dans la collection.
getItemAt(index: number) Renvoie une entrée de légende à l’index donné.
items Obtient l’élément enfant chargé dans cette collection de sites.
ChartLineFormat lineStyle Représente le style de ligne.
weight Représente l’épaisseur de bordure, en points.
ChartPoint dataLabel Renvoie l’étiquette de données d’un point du graphique.
hasDataLabel Indique si un point de données possède une étiquette de données.
markerBackgroundColor Code de couleur HTML de la couleur d’arrière-plan du marqueur d’un point de données (par exemple, #FF0000 représente le rouge).
markerForegroundColor Représentation par code couleur HTML de la couleur de premier plan du marqueur d’un point de données (par exemple, #FF0000 représente le rouge).
markerSize Représente la taille de marqueur d’un point de données.
markerStyle Représente le style du marqueur du point de données de graphique.
ChartPointFormat à la frontière Représente le format de bordure d’un point de données de graphique, qui inclut des informations de couleur, de style et de poids.
ChartSeries type de graphique Représente le type de graphique d’une série.
delete() Supprime la série graphique.
doughnutHoleSize Représente la taille du centre d’une série de graphiques en anneaux.
Filtré Spécifie si la série est filtrée.
gapWidth Représente la largeur de l’intervalle d’une série de graphique.
hasDataLabels Indique si la série comporte des étiquettes de données.
markerBackgroundColor Spécifie la couleur d’arrière-plan du marqueur d’une série de graphiques.
markerForegroundColor Spécifie la couleur de premier plan du marqueur d’une série de graphiques.
markerSize Spécifie la taille de marqueur d’une série de graphiques.
markerStyle Spécifie le style de marqueur d’une série de graphiques.
plotOrder Spécifie l’ordre de traçage d’une série de graphiques dans le groupe de graphiques.
setBubbleSizes(sourceData : Range | string) Définit la taille des bulles pour une série de graphiques.
setValues(sourceData : Range) Définit les valeurs d’une série de graphiques.
setXAxisValues(sourceData : Range) Définit les valeurs de l’axe X d’une série de graphiques.
showShadow Spécifie si la série a une ombre.
Lisse Indique si la série est lisse.
courbes de tendance Collection de courbes de tendance de la série.
ChartSeriesCollection add(name ?: string, index ?: number) Ajouter une nouvelle série à la collection.
ChartTitle getSubstring(start : number, length : number) Obtenir la sous-chaîne d’un titre de graphique.
height Représente la hauteur, exprimée en points, du titre du graphique.
horizontalAlignment Spécifie l’alignement horizontal du titre du graphique.
left Spécifie la distance, en points, entre le bord gauche du titre du graphique et le bord gauche de la zone du graphique.
position Représente la position du titre du graphique.
setFormula(formula : string) Définit une valeur de chaîne qui représente la formule de titre de graphique à l’aide de la notation de style A1.
showShadow Représente une valeur booléenne qui détermine si le titre du graphique a une ombre.
textOrientation Spécifie l’angle d’orientation du texte pour le titre du graphique.
top Spécifie la distance, en points, entre le bord supérieur du titre du graphique et le haut de la zone du graphique.
verticalAlignment Spécifie l’alignement vertical du titre du graphique.
width Spécifie la largeur, en points, du titre du graphique.
ChartTitleFormat à la frontière Représente le format de bordure du titre du graphique, qui inclut la couleur, le style de ligne et l’épaisseur.
ChartTrendline delete() Supprime l’objet courbe de tendance.
format Représente la mise en forme de courbe de tendance de graphique.
Intercepter Représente la valeur intercept de la courbe de tendance.
movingAveragePeriod Représente la période d’une courbe de tendance de graphique.
name Représente le nom de la courbe de tendance.
polynomialOrder Représente l’ordre d’une courbe de tendance de graphique.
type Représente le type de courbe de tendance de graphique.
ChartTrendlineCollection add(type ?: Excel.ChartTrendlineType) Ajoute une nouvelle courbe de tendance à la collection de courbes de tendance.
getCount() Renvoie le nombre de courbes de tendance de la collection.
getItem(index : numérique) Obtient un objet de courbe de tendance par index, qui est l’ordre d’insertion dans le tableau d’éléments.
items Obtient l’élément enfant chargé dans cette collection de sites.
ChartTrendlineFormat line Représente le format des lignes du graphique.
CustomProperty delete() Supprime la propriété personnalisée.
key Clé de la propriété personnalisée.
type Type de valeur utilisée pour la propriété personnalisée.
value Valeur de la propriété personnalisée.
CustomPropertyCollection add(key : string, value : any) Crée une nouvelle propriété personnalisée ou en définit une existante.
deleteAll() Supprime toutes les propriétés personnalisées de cette collection.
getCount() Obtient le nombre des propriétés personnalisées.
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.
DataConnectionCollection refreshAll() Actualise les connexions de données dans la collection, par exemple, d’un tableau croisé dynamique à un jeu de données Power BI, ou d’un modèle de données à une table ou une plage du même classeur.
DocumentProperties auteur L’auteur du classeur.
Catégorie Catégorie du classeur.
comments Le champ Commentaires dans les métadonnées du classeur.
company Compagnie du classeur.
creationDate Obtient la date de création du classeur.
personnalisé Obtient la collection de propriétés personnalisées du classeur.
Mots clés Les mots clés du classeur.
lastAuthor Obtient ou définit le dernier auteur du classeur.
de clusters Le responsable du classeur.
revisionNumber Obtient le numéro de révision du classeur.
subject Sujet du cahier d’exercices.
title Titre du classeur.
NamedItem arrayValues Renvoie un objet contenant les valeurs et les types de l’élément nommé.
formula Formule de l’élément nommé.
NamedItemArrayValues types Représente les types pour chaque élément dans le tableau d’éléments nommé
values Représente les valeurs de chaque élément dans le tableau élément nommé.
Range getAbsoluteResizedRange(numRows : number, numColumns : number) Obtient un objet avec la Range même cellule supérieure gauche que l’objet actuel Range , mais avec le nombre spécifié de lignes et de colonnes.
getImage() Rend la plage sous la forme d’une image PNG codée en Base64.
getSurroundingRegion() Renvoie un Range objet qui représente la région environnante pour la cellule en haut à gauche de cette plage.
lien hypertexte Représente le lien hypertexte de la plage active.
isEntireColumn Représente si la plage active est une colonne entière.
isEntireRow Représente si la plage active est une ligne entière.
numberFormatLocal Représente le code de format de nombre d’Excel pour une plage donnée, en fonction des paramètres de langue de l’utilisateur.
showCard() Affiche la carte pour une cellule active si son contenu est riche en valeur.
style Représente le style de la plage actuelle.
RangeFormat textOrientation Orientation du texte de toutes les cellules dans la plage.
useStandardHeight Détermine si la hauteur de ligne de l’objet Range est égale à la hauteur standard de la feuille.
useStandardWidth Indique si la largeur de colonne de l’objet Range est égale à la largeur standard de la feuille.
RangeHyperlink adresse Représente l’URL cible pour le lien hypertexte.
Référence de document Représente la cible de référence du document pour le lien hypertexte.
info-bulle Représente la chaîne affichée lorsque vous pointez sur le lien hypertexte.
textToDisplay Représente la chaîne qui s’affiche dans la cellule en haut à gauche de la plage.
Style Borders Collection de quatre objets de bordure qui représentent le style des quatre bordures.
builtIn Indique si le style est un style intégré.
delete() Supprime ce style.
fill Remplissage du style.
police Objet Font qui représente la police du style.
formulaHidden Indique si la formule est masquée lorsque la feuille de calcul est protégée.
horizontalAlignment Représente l’alignement horizontal pour le style.
includeAlignment Indique si le style inclut les propriétés retrait automatique, alignement horizontal, alignement vertical, renvoi à la ligne, niveau de retrait et orientation du texte.
includeBorder Indique si le style inclut les propriétés de couleur, d’index de couleur, de style de ligne et de bordure d’épaisseur.
includeFont Indique si le style inclut les propriétés de police suivantes : arrière-plan, gras, couleur, index des couleurs, style de police, italique, nom, taille, barré, indice, exposant et soulignement.
includeNumber Spécifie si le style inclut la propriété de format de nombre.
includePatterns Spécifie si le style inclut les propriétés intérieures color, color index, inverser si negative, pattern, pattern color et pattern color index index.
includeProtection Spécifie si le style inclut les propriétés de protection masquées et verrouillées de formule.
indentLevel Entier compris entre 0 à 250 qui indique le niveau de retrait du style.
locked Spécifie si l’objet est verrouillé lorsque la feuille de calcul est protégée.
name Nom du style.
numberFormat Le code de format du nombre format pour le style.
numberFormatLocal Le code de format localisé du nombre format pour le style.
readingOrder L’ordre de lecture du style.
shrinkToFit Spécifie si le texte est automatiquement réduit pour s’adapter à la largeur de colonne disponible.
verticalAlignment Spécifie l’alignement vertical du style.
wrapText Indique si Excel encapsule le texte dans l’objet.
StyleCollection add(name: string) Ajoute un nouveau style à la collection.
getItem(name: string) Gets a by Style name.
items Obtient l’élément enfant chargé dans cette collection de sites.
Tableau onChanged Se produit lorsque les données dans les cellules changent dans une table spécifique.
onSelectionChanged Se produit lorsque la sélection change sur une table spécifique.
TableChangedEventArgs adresse Obtient l’adresse qui représente la zone modifiée d’un tableau figurant dans une feuille de calcul spécifique.
changeType Obtient le type de modification qui représente la façon dont l’événement modifié est déclenché.
source Obtient la source de l’événement.
tableId Obtient l’ID de la table dans laquelle les données ont changé.
type Obtient le type de l’événement.
worksheetId Obtient l’ID de la feuille de calcul dans laquelle les données ont changé.
TableCollection onChanged Se produit lorsque des données changent dans une table d’un classeur ou d’une feuille de calcul.
TableSelectionChangedEventArgs adresse Obtient l’adresse de plage qui représente la zone sélectionnée d’un tableau dans une feuille de calcul spécifique.
isInsideTable Spécifie si la sélection se trouve à l’intérieur d’une table.
tableId Obtient l’ID de la table dans laquelle la sélection a changé.
type Obtient le type de l’événement.
worksheetId Obtient l’ID de la feuille de calcul dans laquelle la sélection a changé.
Classeur dataConnections Représente toutes les connexions de données dans le classeur.
getActiveCell() Obtient la cellule active du classeur.
name Obtient le nom du classeur.
properties Obtient les propriétés du classeur.
protection Renvoie l’objet de protection pour un classeur.
Les styles Représente une collection de styles associés au classeur.
WorkbookProtection protect(password ?: string) Protège le classeur.
Protégé Indique si le classeur est protégé.
unprotect(password ?: string) Ôte la protection du classeur.
Feuille de calcul copy(positionType ?: Excel.WorksheetPositionType, relativeTo ?: Excel.Worksheet) Copie une feuille de calcul et la place à la position spécifiée.
freezepanes Obtient un objet qui peut être utilisé pour manipuler les volets figés de la feuille de calcul.
getRangeByIndexes(startRow : number, startColumn : number, rowCount : number, columnCount : number) Récupère l’objet Range à partir d’un index de ligne et d’une colonne spécifiques, et s’étend sur un certain nombre de lignes et de colonnes.
onActivated Se produit lorsque la feuille de calcul est activée.
onChanged Se produit lorsque des données changent dans une feuille de calcul spécifique.
onDeactivated Se produit lorsque la feuille de calcul est désactivée.
onSelectionChanged Se produit lorsque la sélection change dans une feuille de calcul spécifique.
standardHeight Renvoie la hauteur standard (par défaut) de toutes les lignes dans la feuille de calcul, en points.
standardWidth Spécifie la largeur standard (par défaut) de toutes les colonnes de la feuille de calcul.
tabColor Couleur de l’onglet de la feuille de calcul.
WorksheetActivatedEventArgs type Obtient le type de l’événement.
worksheetId Obtient l’ID de la feuille de calcul activée.
WorksheetAddedEventArgs source Obtient la source de l’événement.
type Obtient le type de l’événement.
worksheetId Obtient l’ID de la feuille de calcul qui est ajoutée au classeur.
worksheetChangedEventArgs adresse Obtient l’adresse de plage qui représente la zone modifiée dans une feuille de calcul spécifique.
changeType Obtient le type de modification qui représente la façon dont l’événement modifié est déclenché.
source Obtient 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 les données ont changé.
WorksheetCollection onActivated Se produit lorsqu’une feuille de calcul du classeur est activée.
onAdded Se produit lorsqu’une nouvelle feuille de calcul est ajoutée au classeur.
onDeactivated Se produit quand une feuille de calcul du classeur est désactivée.
onDeleted Se produit lorsqu’une feuille de calcul est supprimée du classeur.
WorksheetDeactivatedEventArgs type Obtient le type de l’événement.
worksheetId Obtient l’ID de la feuille de calcul désactivée.
WorksheetDeletedEventArgs source Obtient la source de l’événement.
type Obtient le type de l’événement.
worksheetId Obtient l’ID de la feuille de calcul supprimée du classeur.
WorksheetFreezePanes freezeAt(frozenRange : Range | string) Définit les cellules figées dans l’affichage de la feuille de calcul active.
freezeColumns(count ?: number) Figez la ou les premières colonnes de la feuille de calcul en place.
freezeRows(count ?: number) Figez la ou les lignes supérieures de la feuille de calcul en place.
getLocation() Obtient une plage qui définit les cellules figées dans l’affichage de la feuille de calcul active.
getLocationOrNullObject() Obtient une plage qui définit les cellules figées dans l’affichage de la feuille de calcul active.
unfreeze() Supprime tous les volets figés dans la feuille de calcul.
WorksheetProtection unprotect(password ?: string) Annule la protection d’une feuille de calcul.
WorksheetProtectionOptions allowEditObjects Représente l’option de protection de la feuille de calcul permettant la modification des objets.
allowEditScenarios Représente l’option de protection de la feuille de calcul permettant la modification des scénarios.
selectionMode Représente l’option de protection de feuille de calcul qui autorise le mode sélection.
WorksheetSelectionChangedEventArgs adresse Obtient l’adresse de plage qui représente la zone sélectionnée dans une feuille de calcul spécifique.
type Obtient le type de l’événement.
worksheetId Obtient l’ID de la feuille de calcul dans laquelle la sélection a changé.

Voir aussi