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 un graphique croisé dynamique.
pivot_options Spécifie les contrôles de 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 tracer uniquement les cellules visibles.
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 correspondre à la taille de la fenêtre de la feuille de graphique.
worksheet Obtient la feuille de calcul qui contient ce graphique.
shapes Renvoie toutes les formes de dessin de 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.
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 traçage du graphique qui inclut les étiquettes de graduation des axes.
chart_area Obtient la zone de 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 la table 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 true.
is_rectangular_cornered Obtient ou définit une valeur indiquant si la zone de graphique est rectangulaire.
La valeur par défaut est true.
show_data_table Obtient ou définit une valeur indiquant si le graphique affiche une table de données.
first_slice_angle Obtient ou définit l’angle de la première tranche de graphique à secteurs ou de graphique 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 groupes de barres ou de colonnes, sous forme de 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, sous forme de 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 du graphique 3D (la rotation de la zone de traçage autour de l’axe z, en degrés).
elevation Représente l’élévation de la vue du graphique 3D, en degrés.
right_angle_axes True si les axes du graphique sont à angle droit. S’applique uniquement aux graphiques 3D (sauf Column3D et 3-D Pie Charts).
auto_scaling True 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 %).
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 sous forme de pourcentage de la largeur du graphique (entre 20 et 2 000 %).
actual_chart_size Obtient la taille réelle du graphique en 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
to_image(image_file) 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(image_file, image_type) Crée l’image du graphique et l’enregistre dans un fichier dans le type d’image spécifié.
to_image(image_file, jpeg_quality) Crée l’image du graphique et l’enregistre dans un fichier au format Jpeg.
to_image(stream, jpeg_quality) Crée l’image du graphique et l’enregistre dans un flux au format Jpeg.
to_image(stream, image_type) Crée l’image du graphique et l’enregistre dans un flux au format spécifié.
to_image(image_file, options) 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(stream, options) Crée l’image du graphique et l’enregistre dans un flux au format spécifié.
to_pdf(file_name) Enregistre le graphique dans un fichier pdf.
to_pdf(file_name, desired_page_width, desired_page_height, h_alignment_type, v_alignment_type) Enregistre le graphique dans un fichier pdf.
to_pdf(stream) Crée le graphique pdf et l’enregistre dans un flux.
to_pdf(stream, desired_page_width, desired_page_height, h_alignment_type, v_alignment_type) Crée le graphique pdf et l’enregistre dans un flux.
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 tableau croisé dynamique à partir de sa source de données pivot.
change_template(data) Modifiez le type de graphique avec un modèle prédéfini.
move(upper_left_row, upper_left_column, lower_right_row, lower_right_column) Déplace le graphique vers un emplacement spécifié.
calculate() Calcule la position personnalisée de la zone de tracé, des axes si leur position est attribuée automatiquement.
get_actual_size() Obtient la taille réelle du graphique en pixels.
has_axis(aixs_type, is_primary) Renvoie les axes qui existent sur le graphique.
switch_row_column() Bascule ligne/colonne.
get_chart_data_range() Obtient la plage de sources de données du graphique.
set_chart_data_range(area, is_vertical) Spécifie la plage de données pour un graphique.

Exemple

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

AxisBins classe ChartArea classe