Appliquer les formules de feuille de calcul de graphique dans les présentations en .NET
À propos des formules de feuille de calcul de graphique dans les présentations
Chart spreadsheet (ou feuille de calcul de graphique) dans une présentation est la source de données du graphique. La feuille de calcul de graphique contient des données, qui sont représentées sur le graphique de manière graphique. 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 est créée pour tous les types de graphiques : graphique en courbes, graphique à barres, graphique en rayons, graphique circulaire, etc. Pour voir la feuille de calcul du graphique dans PowerPoint, vous devez double‑cliquer sur le graphique :
La feuille de calcul de graphique contient les noms des éléments du graphique (Nom de catégorie : Category1, Nom de série) et un tableau avec des données numériques correspondant à ces catégories et séries. Par défaut, lorsque vous créez un nouveau graphique, les données de la feuille de calcul sont initialisées avec les données par défaut. Vous pouvez ensuite modifier les données de la feuille de calcul manuellement dans la feuille de calcul.
En général, le graphique représente des données complexes (par exemple des analystes financiers, des analystes scientifiques), avec des cellules calculées à partir des valeurs d’autres cellules ou d’autres données dynamiques. Calculer manuellement la valeur d’une cellule et la coder en dur dans la cellule rend difficile sa modification ultérieure. Si vous modifiez la valeur d’une cellule donnée, toutes les cellules qui en dépendent devront également être mises à jour. De plus, les données d’un tableau peuvent dépendre des données d’autres tableaux, créant un schéma de données de présentation complexe qui doit être mis à jour de manière simple et flexible.
Formule de feuille de calcul de graphique dans une présentation est une expression permettant de calculer et mettre à jour automatiquement les données de la feuille de calcul du graphique. La formule de 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 simple valeur. La formule calcule la valeur et la renvoie, puis cette valeur est affectée à la cellule. Les formules de feuille de calcul de graphique 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 prises en charge pour leur implémentation.
Dans Aspose.Slides la feuille de calcul de graphique est représentée par la propriété Chart.ChartData.ChartDataWorkbook du type IChartDataWorkbook. Une formule de feuille de calcul peut être assignée et modifiée avec la propriété IChartDataCell.Formula. 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 conservent 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 propriété IChartDataCell.Value 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 déclenche une CellUnsupportedDataException pour les formules non prises en charge. Cela s’explique par le fait que lorsque les formules sont analysées avec succès, les dépendances des cellules sont déterminées et la validité des dernières valeurs est vérifiée. Si la formule ne peut pas être analysée, la validité de la valeur de la cellule ne peut pas être garantie.
Ajouter une formule de feuille de calcul de graphique à une présentation
Tout d’abord, ajoutez un graphique avec des données d’exemple à la première diapositive d’une nouvelle présentation avec IShapeCollection.Shapes.AddChart. La feuille de calcul du graphique est créée automatiquement et peut être accédée via la propriété Chart.ChartData.ChartDataWorkbook :
using (var presentation = new Presentation())
{
IChart chart = presentation.Slides[0].Shapes.AddChart(ChartType.ClusteredColumn, 150, 150, 500, 300);
IChartDataWorkbook workbook = chart.ChartData.ChartDataWorkbook;
// ...
}
Écrivons quelques valeurs dans les cellules avec la propriété IChartDataCell.Value du type Object, ce qui signifie que vous pouvez affecter n’importe quelle valeur à la propriété :
workbook.GetCell(0, "F2").Value = -2.5;
workbook.GetCell(0, "G3").Value = 6.3;
workbook.GetCell(0, "H4").Value = 3;
Maintenant, pour écrire une formule dans la cellule, vous pouvez utiliser la propriété IChartDataCell.Formula :
workbook.GetCell(0, "B2").Formula = "F2+G3+H4+1";
Note : la propriété IChartDataCell.Formula est utilisée pour définir des références de cellules de style A1.
Pour définir la référence de cellule R1C1Formula, vous pouvez utiliser la propriété IChartDataCell.R1C1Formula :
workbook.GetCell(0, "C2").R1C1Formula = "R[1]C[4]/R[2]C[5]";
Ensuite, utilisez la méthode IChartDataWorkbook.CalculateFormulas pour calculer toutes les formules du classeur et mettre à jour les valeurs des cellules correspondantes :
workbook.CalculateFormulas();
object value1 = workbook.GetCell(0, "B2"); // 7.8
object value2 = workbook.GetCell(0, "C2"); // 2.1
Constantes logiques
Vous pouvez utiliser des constantes logiques telles que FALSE et TRUE dans les formules de cellules :
Constantes numériques
Les nombres peuvent être utilisés en notation décimale ou scientifique pour créer une formule de feuille de calcul de graphique :
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 : des dates, du texte, des nombres, etc. :
Constantes d’erreur
Il arrive parfois qu’il ne soit 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 être affiché dans une cellule pendant que sa valeur est encore en cours de calcul.
- #N/A - l’information est manquante ou indisponible. Les raisons peuvent être : les cellules utilisées dans la formule sont vides, un espace superflu, une faute de frappe, etc.
- #NAME? - une certaine cellule ou un autre objet de formule est introuvable par son nom.
- #NULL! - peut apparaître lorsqu’il y a une erreur dans la formule, par exemple : (,) ou un espace utilisé à la place d’un deux‑points (:).
- #NUM! - le nombre dans la formule peut être invalide, trop grand ou trop petit, etc.
- #REF! - référence de cellule invalide.
- #VALUE! - type de valeur inattendu. Par exemple, une valeur chaîne affectée à une cellule numérique.
Opérateurs arithmétiques
Vous pouvez utiliser tous les opérateurs arithmétiques dans les formules de la feuille de calcul de graphique :
| Opérateur | Signification | Exemple |
|---|---|---|
| + (signe plus) | Addition ou plus unaire | 2 + 3 |
| - (signe moins) | Soustraction ou négation | 2 - 3 -3 |
| * (astérisque) | Multiplication | 2 * 3 |
| / (slash) | Division | 2 / 3 |
| % (signe pourcentage) | Pourcentage | 30% |
| ^ (caret) | Exponentiation | 2 ^ 3 |
Note : pour modifier l’ordre d’évaluation, entourez de parenthèses la partie de la formule à calculer en premier.
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 soit TRUE soit FALSE :
| Opérateur | Signification | Signification |
|---|---|---|
| = (signe égal) | Égal à | A2 = 3 |
| <> (signe différent) | Différent de | A2 <> 3 |
| > (signe supérieur) | Supérieur à | A2 > 3 |
| >= (signe supérieur ou égal) | Supérieur ou égal à | A2 >= 3 |
| < (signe inférieur) | Inférieur à | A2 < 3 |
| <= (signe 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 de calcul où la colonne possède un identifiant alphabétique (par exemple “A") et la ligne un identifiant numérique (par exemple “1"). Les références de cellules de style A1 peuvent être utilisées de la manière suivante :
| 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 :
Références de cellules de style R1C1
Les références de cellules de style R1C1 sont utilisées pour les feuilles de calcul où à la fois la ligne et la colonne possèdent un identifiant numérique. Les références de cellules de style R1C1 peuvent être utilisées de la manière suivante :
| 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 R1C1 dans une formule :
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 (1900 date system)
- DAYS
- FIND
- FINDB
- IF
- INDEX (reference form)
- LOOKUP (vector form)
- MATCH (vector form)
- MAX
- SUM
- VLOOKUP
FAQ
Les fichiers Excel externes sont-ils pris en charge comme source de données pour un graphique avec 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 à partir d’un fichier XLSX externe à 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, incluez le chemin d’accès et le nom du classeur en utilisant la syntaxe d’Excel.