Formules de feuille de calcul du graphique
À propos de la formule du tableau de données du graphique dans la présentation
Chart spreadsheet (ou chart worksheet) dans une présentation est la source de données du graphique. Le tableau de données du graphique contient des données qui sont représentées graphiquement sur le diagramme. Lorsque vous créez un graphique dans PowerPoint, la feuille de calcul associée à ce graphique est également créée automatiquement. La feuille de calcul du graphique est créée pour tous les types de graphiques : graphique en courbes, graphique à barres, graphique en rayons, graphique circulaire, etc. Pour afficher le tableau de données du graphique dans PowerPoint, double‑cliquez sur le graphique :
Le tableau de données du graphique contient les noms des éléments du graphique (Nom de catégorie : Category1, Nom de série) et un tableau de données numériques correspondant à ces catégories et séries. Par défaut, lors de la création d’un nouveau graphique, les données du tableau sont initialisées avec les valeurs par défaut. Vous pouvez ensuite modifier manuellement les données de la feuille de calcul.
En général, le graphique représente des données complexes (par ex. analystes financiers, analystes scientifiques), avec des cellules calculées à partir des valeurs d’autres cellules ou d’autres données dynamiques. Calculer la valeur d’une cellule manuellement et la coder en dur dans la cellule rend difficile toute modification ultérieure. Si vous modifiez la valeur d’une cellule donnée, toutes les cellules dépendantes devront également être mises à jour. De plus, les données du tableau peuvent dépendre de données provenant d’autres tableaux, créant ainsi un schéma de données de présentation complexe qui doit pouvoir être mis à jour de façon simple et flexible.
Chart spreadsheet formula dans une présentation est une expression permettant de calculer et de mettre à jour automatiquement les données du tableau de données du graphique. La formule de la feuille de calcul définit la logique de calcul des données pour une cellule donnée ou un ensemble de cellules. Une formule de feuille de calcul est une formule mathématique ou logique qui utilise : des références de cellules, des fonctions mathématiques, des opérateurs logiques, des opérateurs arithmétiques, des fonctions de conversion, des constantes de chaîne, etc. La définition de la formule est écrite dans une cellule, et cette cellule ne contient pas une valeur simple. La formule calcule la valeur et la renvoie, puis cette valeur est assignée à la cellule. Les formules de tableau de données des graphiques dans les présentations sont en fait les mêmes que les formules Excel, et les mêmes fonctions, opérateurs et constantes par défaut sont pris en charge pour leur implémentation.
Dans Aspose.Slides le tableau de données du graphique est représenté par la méthode Chart.getChartData.getChartDataWorkbook du type ChartDataWorkbook. Une formule de feuille de calcul peut être assignée ou modifiée avec la méthode ChartDataCell.setFormula. Les fonctionnalités suivantes sont prises en charge pour les formules dans Aspose.Slides :
- Constantes logiques
- Constantes numériques
- Constantes de chaîne
- Constantes d’erreur
- Opérateurs arithmétiques
- Opérateurs de comparaison
- Références de cellules de style A1
- Références de cellules de style R1C1
- Fonctions prédéfinies
En général, les feuilles de calcul stockent les dernières valeurs calculées des formules. Si, après le chargement de la présentation, les données du graphique n’ont pas été modifiées, la méthode ChartDataCell.getValue renvoie ces valeurs lors de la lecture. En revanche, si les données de la feuille de calcul ont été modifiées, la lecture de la propriété ChartDataCell.Value lève l’exception CellUnsupportedDataException pour les formules non prises en charge. Cela s’explique par le fait que lorsqu’une formule est analysée avec succès, les dépendances des cellules sont déterminées et la validité des dernières valeurs est vérifiée. En revanche, si la formule ne peut pas être analysée, la validité de la valeur de la cellule ne peut être garantie.
Ajouter une formule de tableau de données du graphique à la présentation
Tout d’abord, ajoutez un graphique à la première diapositive d’une nouvelle présentation avec ShapeCollection.getShapes.addChart. La feuille de calcul du graphique est créée automatiquement et peut être accédée avec la méthode Chart.getChartData.getChartDataWorkbook :
var pres = new aspose.slides.Presentation();
try {
var chart = pres.getSlides().get_Item(0).getShapes().addChart(aspose.slides.ChartType.ClusteredColumn, 150, 150, 500, 300);
var workbook = chart.getChartData().getChartDataWorkbook();
// ...
} finally {
if (pres != null) {
pres.dispose();
}
}
Écrivons quelques valeurs dans des cellules avec la propriété ChartDataCell.setValue du type Object, ce qui signifie que vous pouvez affecter n’importe quelle valeur à la propriété :
workbook.getCell(0, "F2").setValue(-2.5);
workbook.getCell(0, "G3").setValue(6.3);
workbook.getCell(0, "H4").setValue(3);
Pour écrire une formule dans la cellule, utilisez la méthode ChartDataCell.setFormula :
Note : la méthode ChartDataCell.setFormula sert à définir des références de cellules de style A1.
Pour définir la référence de cellule R1C1Formula , utilisez la méthode ChartDataCell.setR1C1Formula :
Ensuite, si vous lisez les valeurs des cellules B2 et C2, elles seront calculées :
var value1 = cell1.getValue();// 7.8
var value2 = cell2.getValue();// 2.1
Constantes logiques
Vous pouvez utiliser des constantes logiques telles que FALSE et TRUE dans les formules de cellules :
workbook.getCell(0, "A2").setValue(false);
var cell = workbook.getCell(0, "B2");
cell.setFormula("A2 = TRUE");
var value = cell.getValue();// la valeur contient le booléen "false"
Constantes numériques
Les nombres peuvent être utilisés en notation décimale ou scientifique pour créer des formules de tableau de données du graphique :
workbook.getCell(0, "A2").setFormula("1 + 0.5");
workbook.getCell(0, "B2").setFormula(".3 * 1E-2");
Constantes de chaîne
Une constante de chaîne (ou littérale) est une valeur spécifique utilisée telle quelle et qui ne change pas. Les constantes de chaîne peuvent être : dates, textes, nombres, etc. :
workbook.getCell(0, "A2").setFormula("\"abc\"");
workbook.getCell(0, "B2").setFormula("\"2/3/2020 12:00\"");
Constantes d’erreur
Parfois il n’est pas possible de calculer le résultat d’une formule. Dans ce cas, le code d’erreur apparaît dans la cellule à la place de sa valeur. Chaque type d’erreur possède un code spécifique :
- #DIV/0! - la formule tente de diviser par zéro.
- #GETTING_DATA - peut s’afficher dans une cellule dont la valeur est encore en cours de calcul.
- #N/A - information manquante ou indisponible. Les raisons peuvent être : cellule utilisée vide, espace supplémentaire, faute de frappe, etc.
- #NAME? - une cellule ou un autre objet de formule ne peut pas être trouvé par son nom.
- #NULL! - peut apparaître lorsqu’une erreur de syntaxe est présente, par ex. : (,) ou un espace utilisé à la place d’un deux‑points (:).
- #NUM! - le nombre dans la formule est invalide, trop long ou trop petit, etc.
- #REF! - référence de cellule invalide.
- #VALUE! - type de valeur inattendu. Par exemple, une chaîne assignée à une cellule numérique.
var cell = workbook.getCell(0, "A2");
cell.setFormula("2 / 0");
var value = cell.getValue();// la valeur contient la chaîne "#DIV/0!"
Opérateurs arithmétiques
Vous pouvez utiliser tous les opérateurs arithmétiques dans les formules du tableau du graphique :
| Opérateur | Signification | Exemple |
|---|---|---|
| + (signe plus) | Addition ou signe unaire | 2 + 3 |
| - (signe moins) | Soustraction ou négation | 2 - 3 -3 |
| * (astérisque) | Multiplication | 2 * 3 |
| / (barre oblique) | Division | 2 / 3 |
| % (pourcentage) | Pourcentage | 30% |
| ^ (accent circonflexe) | Exponentiation | 2 ^ 3 |
Note : pour modifier l’ordre d’évaluation, encadrez la partie de la formule à calculer en premier avec des parenthèses.
Opérateurs de comparaison
Vous pouvez comparer les valeurs des cellules avec les opérateurs de comparaison. Lorsque deux valeurs sont comparées à l’aide de ces opérateurs, le résultat est une valeur logique TRUE ou FALSE :
| Opérateur | Signification | Exemple |
|---|---|---|
| = (égal) | Égal à | A2 = 3 |
| <> (différent) | Différent de | A2 <> 3 |
| > (supérieur) | Supérieur à | A2 > 3 |
| >= (supérieur ou égal) | Supérieur ou égal à | A2 >= 3 |
| < (inférieur) | Inférieur à | A2 < 3 |
| <= (inférieur ou égal) | Inférieur ou égal à | A2 <= 3 |
Références de cellules de style A1
Les références de cellules de style A1 sont utilisées pour les feuilles où la colonne possède un identifiant alphabétique (ex. * A *) et la ligne un identifiant numérique (ex. 1). Elles peuvent être employées comme suit :
| Référence de cellule | Exemple | ||
|---|---|---|---|
| Absolue | Relative | Mixte | |
| Cellule | $A$2 | A2 | A$2 $A2 |
| Ligne | $2:$2 | 2:2 | - |
| Colonne | $A:$A | A:A | - |
| Plage | $A$2:$C$4 | A2:C4 | $A$2:C4 A$2:$C4 |
Voici un exemple d’utilisation d’une référence de cellule de style A1 dans une formule :
workbook.getCell(0, "A2").setFormula("C3 + SUM(F2:H5)");
Références de cellules de style R1C1
Les références de cellules de style R1C1 sont utilisées pour les feuilles où ligne et colonne ont toutes deux un identifiant numérique. Elles peuvent être employées comme suit :
| Référence de cellule | Exemple | ||
|---|---|---|---|
| Absolue | Relative | Mixte | |
| Cellule | R2C3 | R[2]C[3] | R2C[3] R[2]C3 |
| Ligne | R2 | R[2] | - |
| Colonne | C3 | C[3] | - |
| Plage | R2C3:R5C7 | R[2]C[3]:R[5]C[7] | R2C3:R[5]C[7] R[2]C3:R5C[7] |
Voici un exemple d’utilisation d’une référence de cellule de style A1 dans une formule :
workbook.getCell(0, "A2").setR1C1Formula("R2C4 + SUM(R5C6:R7C9)");
Fonctions prédéfinies
Il existe des fonctions prédéfinies qui peuvent être utilisées dans les formules pour simplifier leur implémentation. Ces fonctions encapsulent les opérations les plus couramment utilisées, telles que :
- ABS
- AVERAGE
- CEILING
- CHOOSE
- CONCAT
- CONCATENATE
- DATE (système de dates 1900)
- DAYS
- FIND
- FINDB
- IF
- INDEX (forme de référence)
- LOOKUP (forme vectorielle)
- MATCH (forme vectorielle)
- MAX
- SUM
- VLOOKUP
FAQ
Les fichiers Excel externes sont‑ils pris en charge comme source de données pour un graphique contenant des formules ?
Oui. Aspose.Slides prend en charge les classeurs externes comme source de données d’un graphique, ce qui vous permet d’utiliser des formules depuis un fichier XLSX extérieur à la présentation.
Les formules de graphique peuvent‑elles référencer des feuilles du même classeur par leur nom ?
Oui. Les formules suivent le modèle de référence standard d’Excel, vous pouvez donc référencer d’autres feuilles du même classeur ou d’un classeur externe. Pour les références externes, indiquez le chemin et le nom du classeur en utilisant la syntaxe Excel.