Chart classe
Chart classe
Encapsule l’objet qui représente un seul graphique Excel.
Le type Chart expose les membres suivants :
Propriétés
| Propriété | Description |
|---|---|
| style | Obtient et définit le style intégré. |
| chart_object | Représente le chartShape ; |
| hide_pivot_field_buttons | Indique si les boutons de champ du graphique croisé dynamique sont masqués uniquement lorsque le graphique est de type PivotChart. |
| pivot_options | Spécifie les contrôles pivot qui apparaissent sur le graphique |
| pivot_source | La source est les données du tableau croisé dynamique. Si PivotSource n’est pas vide, le graphique est PivotChart. |
| plot_by | Obtient et définit s’il s’agit d’un tracé par ligne ou par colonne. |
| plot_empty_cells_type | Obtient et définit comment tracer les cellules vides. |
| plot_visible_cells | Indique si seules les cellules visibles sont tracées. |
| plot_visible_cells_only | Indique si seules les cellules visibles sont tracées. |
| display_na_as_blank | Indique si #N/A est affiché comme valeur vide. |
| name | Obtient et définit le nom du graphique. |
| size_with_window | True si Microsoft Excel redimensionne le graphique pour qu’il corresponde à la taille de la fenêtre de la feuille graphique. |
| worksheet | Obtient la feuille de calcul qui contient ce graphique. |
| shapes | Renvoie toutes les formes de dessin dans ce graphique. |
| print_size | Obtient et définit la taille du graphique imprimé. |
| type | Obtient ou définit le type d’un graphique. |
| n_series | Obtient une collection SeriesCollection représentant la série de données dans le graphique. |
| filtered_n_series | Obtient une collection SeriesCollection représentant les séries de données filtrées dans le graphique. |
| title | Obtient le titre du graphique. |
| sub_title | Obtient le sous-titre du graphique. Uniquement pour le fichier au format ODS. |
| plot_area | Obtient la zone de tracé du graphique qui inclut les étiquettes de graduation des axes. |
| chart_area | Obtient la zone graphique dans la feuille de calcul. |
| category_axis | Obtient l’axe X du graphique. |
| value_axis | Obtient l’axe Y du graphique. |
| second_value_axis | Obtient le deuxième axe Y du graphique. |
| second_category_axis | Obtient le deuxième axe X du graphique. |
| series_axis | Obtient l’axe des séries du graphique. |
| legend | Obtient la légende du graphique. |
| chart_data_table | Représente le tableau de données du graphique. |
| show_legend | Obtient ou définit une valeur indiquant si la légende du graphique sera affichée. La valeur par défaut est vraie. |
| is_rectangular_cornered | Obtient ou définit une valeur indiquant si la zone du graphique est rectangulaire. La valeur par défaut est vraie. |
| show_data_table | Obtient ou définit une valeur indiquant si le graphique affiche un tableau de données. |
| first_slice_angle | Obtient ou définit l’angle de la première tranche de diagramme circulaire ou de diagramme en anneau, en degrés (dans le sens des aiguilles d’une montre à partir de la verticale). S’applique uniquement aux graphiques à secteurs, à secteurs 3D et en anneau, de 0 à 360. |
| gap_width | Renvoie ou définit l’espace entre les clusters de barres ou de colonnes, en pourcentage de la largeur de la barre ou de la colonne. La valeur de cette propriété doit être comprise entre 0 et 500. |
| gap_depth | Obtient ou définit la distance entre les séries de données dans un graphique 3D, en pourcentage de la largeur du marqueur. La valeur de cette propriété doit être comprise entre 0 et 500. |
| floor | Renvoie un objet Chart.floor qui représente les murs d’un graphique 3D. |
| walls | Renvoie un objet Chart.walls qui représente les murs d’un graphique 3D. |
| back_wall | Renvoie un objet Chart.walls qui représente le mur arrière d’un graphique 3D. |
| side_wall | Renvoie un objet Chart.walls qui représente la paroi latérale d’un graphique 3D. |
| walls_and_gridlines_2d | True si le quadrillage est dessiné en deux dimensions sur un graphique 3D. |
| rotation_angle | Représente la rotation de la vue graphique 3D (la rotation de la zone de tracé autour de l’axe z, en degrés). |
| elevation | Représente l’élévation de la vue cartographique 3D, en degrés. |
| right_angle_axes | Vrai si les axes du graphique sont à angles droits. S’applique uniquement aux graphiques 3D (à l’exception des diagrammes Column3D et des diagrammes circulaires 3D). |
| auto_scaling | Vrai si Microsoft Excel met à l’échelle un graphique 3D afin qu’il soit plus proche en taille du graphique 2D équivalent. La propriété RightAngleAxes doit être True. |
| height_percent | Renvoie ou définit la hauteur d’un graphique 3D sous forme de pourcentage de la largeur du graphique (entre 5 et 500 pour cent). |
| perspective | Renvoie ou définit la perspective de la vue graphique 3D. Doit être compris entre 0 et 100. Cette propriété est ignorée si la propriété RightAngleAxes est True. |
| is_3d | Indique si le graphique est un graphique 3D. |
| depth_percent | Représente la profondeur d’un graphique 3D en pourcentage de la largeur du graphique (entre 20 et 2 000 pour cent). |
| actual_chart_size | Obtient la taille réelle du graphique en unités de pixels. |
| placement | Représente la manière dont le graphique est attaché aux cellules situées en dessous. |
| page_setup | Représente la description de la mise en page dans ce graphique. |
| line | Obtient la ligne. |
Méthodes
| Méthode | Description |
|---|---|
| calculate | Calcule la position personnalisée de la zone de tracé, les axes si leur position est automatiquement attribuée. |
| calculate | Calcule la position personnalisée de la zone de tracé, les axes si leur position est automatiquement attribuée, avec les options de calcul de graphique. |
| to_image | Crée l’image du graphique et l’enregistre dans un fichier. L’extension du nom de fichier détermine le format de l’image. |
| to_image | Crée l’image du graphique et l’enregistre dans un fichier dans le type d’image spécifié. |
| to_image | Crée l’image du graphique et l’enregistre dans un fichier au format Jpeg. |
| to_image | Crée l’image du graphique et l’enregistre dans un flux au format Jpeg. |
| to_image | Crée l’image du graphique et l’enregistre dans un flux au format spécifié. |
| to_image | Crée l’image du graphique et l’enregistre dans un fichier. L’extension du nom de fichier détermine le format de l’image. |
| to_image | Crée l’image du graphique et l’enregistre dans un flux au format spécifié. |
| to_pdf | Enregistre le graphique dans un fichier pdf. |
| to_pdf | Enregistre le graphique dans un fichier pdf. |
| to_pdf | Crée le graphique PDF et l’enregistre dans un flux. |
| to_pdf | Crée le graphique PDF et l’enregistre dans un flux. |
| is_refered_by_chart | Indique si la cellule référencée par le graphique. |
| is_cell_refered_by_chart | Indique si la cellule référencée par le graphique. |
| is_chart_data_changed | Détecte si la source de données d’un graphique a changé. |
| refresh_pivot_data | Actualise les données du graphique croisé dynamique à partir de sa source de données pivot. |
| change_template | Changez le type de graphique avec un modèle prédéfini. |
| move | Déplace le graphique vers un emplacement spécifié. |
| get_actual_size | Obtient la taille réelle du graphique en unités de pixels. |
| has_axis | Renvoie les axes qui existent sur le graphique. |
| switch_row_column | Change de ligne/colonne. |
| get_chart_data_range | Obtient la plage de sources de données du graphique. |
| set_chart_data_range | Spécifie la plage de données pour un graphique. |
Exemple
Les codes suivants montrent comment créer un graphique avec des codes .Net.
from aspose.cells import Workbook
from aspose.cells.charts import ChartType
workbook = Workbook()
sheet = workbook.worksheets[0]
cells = sheet.cells
cells.get(0, 1).put_value("Income")
cells.get(1, 0).put_value("Company A")
cells.get(2, 0).put_value("Company B")
cells.get(3, 0).put_value("Company C")
cells.get(1, 1).put_value(10000)
cells.get(2, 1).put_value(20000)
cells.get(3, 1).put_value(30000)
chartIndex = sheet.charts.add(ChartType.COLUMN, 9, 9, 21, 15)
chart = sheet.charts[chartIndex]
chart.set_chart_data_range("A1:B4", True)
chart.show_legend = True
chart.title.text = "Income Analysis"
Voir également
- module
aspose.cells.charts - classe
SeriesCollection
