Chart

Chart class

Encapsule l’objet qui représente un seul graphique Excel.

public class Chart

Propriétés

Nom	La description
AutoScaling { get; set; }	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.
BackWall { get; }	Renvoie un`Walls` objet qui représente le mur arrière d’un graphique 3D.
CategoryAxis { get; }	Obtient l’axe X du graphique.
ChartArea { get; }	Obtient la zone de graphique dans la feuille de calcul.
ChartDataTable { get; }	Représente la table de données du graphique.
ChartObject { get; }	Représente la forme du graphique ;
DepthPercent { get; set; }	Représente la profondeur d’un graphique 3D sous forme de pourcentage de la largeur du graphique (entre 20 et 2 000 %).
DisplayNaAsBlank { get; set; }	Indique si #N/A est affiché comme valeur vide.
Elevation { get; set; }	Représente l’élévation de la vue cartographique 3D, en degrés.
FirstSliceAngle { get; set; }	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.
Floor { get; }	Renvoie un`Floor` objet qui représente les murs d’un graphique 3D.
GapDepth { get; set; }	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.
GapWidth { get; set; }	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.
HeightPercent { get; set; }	Renvoie ou définit la hauteur d’un graphique 3D sous forme de pourcentage de la largeur du graphique (entre 5 et 500 %).
HidePivotFieldButtons { get; set; }	Indique si les boutons de champ du graphique croisé dynamique sont masqués uniquement lorsque le graphique est PivotChart.
Is3D { get; }	Indique si le graphique est un graphique 3D.
IsRectangularCornered { get; set; }	Obtient ou définit une valeur indiquant si la zone du graphique est rectangulaire. La valeur par défaut est true.
Legend { get; }	Obtient la légende du graphique.
Line { get; }	Obtient la ligne.
Name { get; set; }	Obtient et définit le nom du graphique.
NSeries { get; }	Obtient un`SeriesCollection` collection représentant la série de données dans le graphique.
PageSetup { get; }	Représente la description de la mise en page dans ce tableau.
Perspective { get; set; }	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.
PivotOptions { get; }	Spécifie les contrôles de pivot qui apparaissent sur le graphique
PivotSource { get; set; }	La source est les données du tableau croisé dynamique. Si PivotSource n’est pas vide, le graphique est PivotChart.
Placement { get; set; }	Représente la façon dont le graphique est attaché aux cellules en dessous.
PlotArea { get; }	Obtient la zone de tracé du graphique qui inclut les étiquettes de graduation des axes.
PlotBy { get; }	Obtient et définit si le tracé est par ligne ou par colonne.
PlotEmptyCellsType { get; set; }	Obtient et définit comment tracer les cellules vides.
PlotVisibleCells { get; set; }	Indique si seules les cellules visibles sont tracées.
PrintSize { get; set; }	Obtient et définit la taille du graphique imprimé.
RightAngleAxes { get; set; }	Vrai si les axes du graphique sont à angle droit. S’applique uniquement aux graphiques 3D (sauf Column3D et 3-D Pie Charts).
RotationAngle { get; set; }	Représente la rotation de la vue du graphique 3D (la rotation de la zone de tracé autour de l’axe z, en degrés).
SecondCategoryAxis { get; }	Obtient le deuxième axe X du graphique.
SecondValueAxis { get; }	Obtient le deuxième axe Y du graphique.
SeriesAxis { get; }	Obtient l’axe des séries du graphique.
Shapes { get; }	Renvoie toutes les formes de dessin dans ce graphique.
ShowDataTable { get; set; }	Obtient ou définit une valeur indiquant si le graphique affiche une table de données.
ShowLegend { get; set; }	Obtient ou définit une valeur indiquant si la légende du graphique sera affichée. La valeur par défaut est true.
SideWall { get; }	Renvoie un`Walls`objet qui représente la paroi latérale d’un graphique 3D.
SizeWithWindow { get; set; }	Vrai si Microsoft Excel redimensionne le graphique pour correspondre à la taille de la fenêtre de la feuille de graphique.
Style { get; set; }	Obtient et définit le style intégré.
SubTitle { get; }	Récupère le sous-titre du graphique. Uniquement pour les fichiers au format ODS.
Title { get; }	Obtient le titre du graphique.
Type { get; set; }	Obtient ou définit le type d’un graphique.
ValueAxis { get; }	Obtient l’axe Y du graphique.
Walls { get; }	Renvoie un`Walls` objet qui représente les murs d’un graphique 3D.
WallsAndGridlines2D { get; set; }	Vrai si le quadrillage est dessiné en deux dimensions sur un graphique 3D.
Worksheet { get; }	Obtient la feuille de calcul qui contient ce graphique.

Méthodes

Nom	La description
Calculate()	Calcule la position personnalisée de la zone de tracé, des axes si la position d’entre eux est attribuée automatiquement.
GetActualSize()	Obtient la taille réelle du graphique en pixels.
GetChartDataRange()	Obtient la plage de sources de données du graphique.
HasAxis(AxisType, bool)	Renvoie les axes qui existent sur le graphique.
IsChartDataChanged()	Détecte si la source de données d’un graphique a changé.
Move(int, int, int, int)	Déplace le graphique vers un emplacement spécifié.
RefreshPivotData()	Actualise les données du tableau croisé dynamique à partir de sa source de données pivot.
SetChartDataRange(string, bool)	Spécifie la plage de données pour un graphique.
SwitchRowColumn()	Bascule ligne/colonne.
ToImage()	Obtient un 32 bits`Bitmap` objet du graphique.
ToImage(ImageOrPrintOptions)	Obtient un 32 bits`Bitmap` objet du graphique. `ImageOrPrintOptions.ImageFormatImageOrPrintOptions.ImageFormat` , les attributs ImageOrPrintOptions.TiffCompression et ImageOrPrintOptions.Quality sont ignorés.
ToImage(string)	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.
ToImage(Stream, ImageOrPrintOptions)	Crée l’image du graphique et l’enregistre dans un flux au format spécifié.
ToImage(Stream, ImageType)	Crée l’image du graphique et l’enregistre dans un flux au format spécifié.
ToImage(Stream, long)	Crée l’image du graphique et l’enregistre dans un flux au format Jpeg.
ToImage(string, ImageOrPrintOptions)	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.
ToImage(string, ImageType)	Crée l’image du graphique et l’enregistre dans un fichier dans le type d’image spécifié.
ToImage(string, long)	Crée l’image du graphique et l’enregistre dans un fichier au format Jpeg.
ToPdf(Stream)	Crée le graphique pdf et l’enregistre dans un flux.
ToPdf(string)	Enregistre le graphique dans un fichier pdf.
ToPdf(Stream, float, float, PageLayoutAlignmentType, PageLayoutAlignmentType)	Crée le graphique pdf et l’enregistre dans un flux.
ToPdf(string, float, float, PageLayoutAlignmentType, PageLayoutAlignmentType)	Enregistre le graphique dans un fichier pdf.

Exemples

[C#]

Workbook workbook = new Workbook();
Worksheet sheet = workbook.Worksheets[0];

Cells cells = sheet.Cells;
cells[0,1].PutValue("Income");
cells[1,0].PutValue("Company A");
cells[2,0].PutValue("Company B");
cells[3,0].PutValue("Company C");
cells[1,1].PutValue(10000);
cells[2,1].PutValue(20000);
cells[3,1].PutValue(30000);
		
int chartIndex = sheet.Charts.Add(ChartType.Column, 9, 9, 21, 15);

Chart chart = sheet.Charts[chartIndex];
chart.SetChartDataRange("A1:B4", true);
chart.ShowLegend = true;
chart.Title.Text = "Income Analysis";

[Visual Basic]

Dim workbook as Workbook = new Workbook()
Dim sheet as Worksheet = workbook.Worksheets(0)

Dim cells as Cells = sheet.Cells
cells(0,1).PutValue("Income")
cells(1,0).PutValue("Company A")
cells(2,0).PutValue("Company B")
cells(3,0).PutValue("Company C")
cells(1,1).PutValue(10000)
cells(2,1).PutValue(20000)
cells(3,1).PutValue(30000)
		
Dim chartIndex as Integer = sheet.Charts.Add(ChartType.Column, 9, 9, 21, 15)

Dim chart as Chart = sheet.Charts(chartIndex) 
chart.SetChartDataRange("A1:B4", True);
chart.ShowLegend = True
chart.Title.Text = "Income Analysis"

Voir également

espace de noms Aspose.Cells.Charts
Assemblée Aspose.Cells

CategoryType ChartArea