Class Axis

Class Axis

Namespace: Aspose.Cells.Charts
Assembly: Aspose.Cells.dll (25.2.0)

Encapsule l’objet qui représente un axe de graphique.

public class Axis

Héritage

objectAxis

Membres hérités

object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

Exemples

À partir des codes suivants, vous pouvez apprendre à définir l’unité, la valeur maximale et la valeur minimale de l’axe.

//Instanciation d'un objet Workbook
Workbook workbook = new Workbook();
//Ajout d'une nouvelle feuille de calcul à l'objet Excel
int sheetIndex = workbook.Worksheets.Add();
//Obtention de la référence de la feuille de calcul nouvellement ajoutée en passant son index de feuille
Worksheet worksheet = workbook.Worksheets[sheetIndex];
//Ajout d'une valeur d'exemple à la cellule "A1"
worksheet.Cells["A1"].PutValue(50);
//Ajout d'une valeur d'exemple à la cellule "A2"
worksheet.Cells["A2"].PutValue(100);
//Ajout d'une valeur d'exemple à la cellule "A3"
worksheet.Cells["A3"].PutValue(150);
//Ajout d'une valeur d'exemple à la cellule "B1"
worksheet.Cells["B1"].PutValue(4);
//Ajout d'une valeur d'exemple à la cellule "B2"
worksheet.Cells["B2"].PutValue(20);
//Ajout d'une valeur d'exemple à la cellule "B3"
worksheet.Cells["B3"].PutValue(50);
//Ajout d'un graphique à la feuille de calcul
int chartIndex = worksheet.Charts.Add(ChartType.Column, 5, 0, 25, 5);
//Accès à l'instance du graphique nouvellement ajouté
Chart chart = worksheet.Charts[chartIndex];
//Ajout de NSeries (source de données du graphique) au graphique allant de la cellule "A1" à "B3"
chart.NSeries.Add("A1:B3", true);
//Définir la valeur max de l'axe des valeurs
chart.ValueAxis.MaxValue = 200;
//Définir la valeur min de l'axe des valeurs
chart.ValueAxis.MinValue = 0;
//Définir l'unité majeure
chart.ValueAxis.MajorUnit = 25;
//L'axe des catégories (X) croise à la valeur maximale.
chart.ValueAxis.CrossType = CrossType.Maximum;
//Définir le nombre de catégories ou de séries entre les étiquettes de graduation. 
chart.CategoryAxis.TickLabelSpacing = 2;

//faites vos affaires

//Sauvegarde du fichier Excel
workbook.Save("book1.xlsx");
'Instanciation d'un objet Workbook
Dim workbook As Workbook = New Workbook()
'Ajout d'une nouvelle feuille de calcul à l'objet Excel
Dim sheetIndex As Int32 = workbook.Worksheets.Add()
'Obtention de la référence de la feuille de calcul nouvellement ajoutée en passant son index de feuille
Dim worksheet As Worksheet = workbook.Worksheets(sheetIndex)
'Ajout d'une valeur d'exemple à la cellule "A1"
worksheet.Cells("A1").PutValue(50)
'Ajout d'une valeur d'exemple à la cellule "A2"
worksheet.Cells("A2").PutValue(100)
'Ajout d'une valeur d'exemple à la cellule "A3"
worksheet.Cells("A3").PutValue(150)
'Ajout d'une valeur d'exemple à la cellule "B1"
worksheet.Cells("B1").PutValue(4)
'Ajout d'une valeur d'exemple à la cellule "B2"
worksheet.Cells("B2").PutValue(20)
'Ajout d'une valeur d'exemple à la cellule "B3"
worksheet.Cells("B3").PutValue(50)
'Ajout d'un graphique à la feuille de calcul
Dim chartIndex As Int32 = worksheet.Charts.Add(ChartType.Column, 5, 0, 25, 5)
'Accès à l'instance du graphique nouvellement ajouté
Dim chart As Chart = worksheet.Charts(chartIndex)
'Ajout de NSeries (source de données du graphique) au graphique allant de la cellule "A1" à "B3"
chart.NSeries.Add("A1:B3", True)
'Définir la valeur max de l'axe des valeurs
chart.ValueAxis.MaxValue = 200
'Définir la valeur min de l'axe des valeurs
chart.ValueAxis.MinValue = 0
'Définir l'unité majeure
chart.ValueAxis.MajorUnit = 25
'L'axe des catégories (X) croise à la valeur maximale.
chart.ValueAxis.CrossType = CrossType.Maximum
'Définir le nombre de catégories ou de séries entre les étiquettes de graduation. 
chart.CategoryAxis.TickLabelSpacing = 2
'Sauvegarde du fichier Excel
workbook.Save("book1.xlsx")

Propriétés

Area

Obtient l’Aspose.Cells.Charts.Axis.Area.

public Area Area { get; }

Valeur de la propriété

Area

AxisBetweenCategories

Représente si l’axe des valeurs croise l’axe des catégories entre les catégories.

public bool AxisBetweenCategories { get; set; }

Valeur de la propriété

bool

Remarques

Cette propriété s’applique uniquement aux axes de catégorie et ne s’applique pas aux graphiques 3D.

AxisLine

Obtient l’apparence d’un axe.

public Line AxisLine { get; }

Valeur de la propriété

Line

BaseUnitScale

Représente l’échelle de l’unité de base pour l’axe des catégories.

public TimeUnit BaseUnitScale { get; set; }

Valeur de la propriété

TimeUnit

Remarques

La définition de cette propriété n’a d’effet que lorsque la propriété CategoryType est définie sur TimeScale.

Bins

Représente les classes sur un axe de graphique (Histogramme/Pareto)

public AxisBins Bins { get; }

Valeur de la propriété

AxisBins

CategoryType

Représente le type d’axe de catégorie.

public CategoryType CategoryType { get; set; }

Valeur de la propriété

CategoryType

CrossAt

Représente le point sur l’axe des valeurs où l’axe des catégories le croise.

public double CrossAt { get; set; }

Valeur de la propriété

double

Remarques

Le nombre doit être un entier lorsqu’il s’applique à l’axe des catégories. Et la valeur doit être comprise entre 1 et 31999.

CrossType

Représente le Aspose.Cells.Charts.Axis.CrossType sur l’axe spécifié où l’autre axe croise.

public CrossType CrossType { get; set; }

Valeur de la propriété

CrossType

CustomDisplayUnit

Spécifie une valeur personnalisée pour l’unité d’affichage.

public double CustomDisplayUnit { get; set; }

Valeur de la propriété

double

DisplayUnit

Représente l’étiquette d’unité pour l’axe spécifié.

public DisplayUnitType DisplayUnit { get; set; }

Valeur de la propriété

DisplayUnitType

DisplayUnitLabel

Représente une étiquette d’unité sur un axe dans le graphique spécifié. Les étiquettes d’unité sont utiles pour le traçage de grandes valeurs— par exemple, dans les millions ou les milliards.

public DisplayUnitLabel DisplayUnitLabel { get; }

Valeur de la propriété

DisplayUnitLabel

HasMultiLevelLabels

Indique si les étiquettes doivent être affichées comme multi-niveaux.

public bool HasMultiLevelLabels { get; set; }

Valeur de la propriété

bool

Remarques

Valide uniquement pour l’axe de catégorie.

IsAutoTickLabelSpacing

Indique si l’espacement des étiquettes de graduation est automatique.

public bool IsAutoTickLabelSpacing { get; set; }

Valeur de la propriété

bool

IsAutomaticMajorUnit

Indique si l’unité majeure de l’axe est automatiquement assignée.

public bool IsAutomaticMajorUnit { get; set; }

Valeur de la propriété

bool

IsAutomaticMaxValue

Indique si la valeur max est automatiquement assignée.

public bool IsAutomaticMaxValue { get; set; }

Valeur de la propriété

bool

IsAutomaticMinValue

Indique si la valeur min est automatiquement assignée.

public bool IsAutomaticMinValue { get; set; }

Valeur de la propriété

bool

IsAutomaticMinorUnit

Indique si l’unité mineure de l’axe est automatiquement assignée.

public bool IsAutomaticMinorUnit { get; set; }

Valeur de la propriété

bool

IsDisplayUnitLabelShown

Représente si l’étiquette d’unité d’affichage est affichée sur l’axe spécifié.

public bool IsDisplayUnitLabelShown { get; set; }

Valeur de la propriété

bool

Remarques

La valeur par défaut est True.

IsLogarithmic

Représente si le type d’échelle de l’axe des valeurs est logarithmique ou non.

public bool IsLogarithmic { get; set; }

Valeur de la propriété

bool

IsPlotOrderReversed

Représente si Microsoft Excel trace les points de données du dernier au premier.

public bool IsPlotOrderReversed { get; set; }

Valeur de la propriété

bool

IsVisible

Représente si l’axe est visible.

public bool IsVisible { get; set; }

Valeur de la propriété

bool

LogBase

Représente la base logarithmique. La valeur par défaut est 10. S’applique uniquement pour Excel2007.

public double LogBase { get; set; }

Valeur de la propriété

double

MajorGridLines

Représente les lignes de grille majeures sur un axe de graphique.

public Line MajorGridLines { get; }

Valeur de la propriété

Line

Exemples

chart.ValueAxis.MajorGridLines.IsVisible = false;
chart.CategoryAxis.MajorGridLines.IsVisible = true;
chart.ValueAxis.MajorGridLines.IsVisible = false
chart.CategoryAxis.MajorGridLines.IsVisible = true

MajorTickMark

Représente le type de marque de graduation majeure pour l’axe spécifié.

public TickMarkType MajorTickMark { get; set; }

Valeur de la propriété

TickMarkType

MajorUnit

Représente les unités majeures pour l’axe.

public double MajorUnit { get; set; }

Valeur de la propriété

double

Remarques

Les unités majeures doivent être supérieures à zéro.

MajorUnitScale

Représente l’échelle de l’unité majeure pour l’axe des catégories.

public TimeUnit MajorUnitScale { get; set; }

Valeur de la propriété

TimeUnit

Exemples

chart.CategoryAxis.CategoryType = CategoryType.TimeScale;
chart.CategoryAxis.MajorUnitScale = TimeUnit.Months;
chart.CategoryAxis.MajorUnit = 2;
chart.CategoryAxis.CategoryType = CategoryType.TimeScale
chart.CategoryAxis.MajorUnitScale = TimeUnit.Months
chart.CategoryAxis.MajorUnit = 2

MaxValue

Représente la valeur maximale sur l’axe des valeurs.

public object MaxValue { get; set; }

Valeur de la propriété

object

Remarques

Le type de maxValue ne peut être que double ou DateTime.

MinValue

Représente la valeur minimale sur l’axe des valeurs.

public object MinValue { get; set; }

Valeur de la propriété

object

Remarques

Le type de minValue ne peut être que double ou DateTime.

MinorGridLines

Représente les lignes de grille mineures sur un axe de graphique.

public Line MinorGridLines { get; }

Valeur de la propriété

Line

MinorTickMark

Représente le type de marque de graduation mineure pour l’axe spécifié.

public TickMarkType MinorTickMark { get; set; }

Valeur de la propriété

TickMarkType

MinorUnit

Représente les unités mineures pour l’axe.

public double MinorUnit { get; set; }

Valeur de la propriété

double

Remarques

Les unités mineures doivent être supérieures à zéro.

MinorUnitScale

Représente l’échelle de l’unité majeure pour l’axe des catégories.

public TimeUnit MinorUnitScale { get; set; }

Valeur de la propriété

TimeUnit

Exemples

chart.CategoryAxis.CategoryType = CategoryType.TimeScale;
chart.CategoryAxis.MinorUnitScale = TimeUnit.Months;
chart.CategoryAxis.MinorUnit = 2;
chart.CategoryAxis.CategoryType = CategoryType.TimeScale
chart.CategoryAxis.MinorUnitScale = TimeUnit.Months
chart.CategoryAxis.MinorUnit = 2

TickLabelPosition

Représente la position des étiquettes de graduation sur l’axe spécifié.

public TickLabelPositionType TickLabelPosition { get; set; }

Valeur de la propriété

TickLabelPositionType

TickLabelSpacing

Représente le nombre de catégories ou de séries entre les étiquettes de graduation. S’applique uniquement aux axes de catégorie et de séries.

public int TickLabelSpacing { get; set; }

Valeur de la propriété

int

Remarques

Le nombre doit être compris entre 1 et 31999.

TickLabels

Retourne un objet Aspose.Cells.Charts.Axis.TickLabels qui représente les étiquettes de graduation pour l’axe spécifié.

public TickLabels TickLabels { get; }

Valeur de la propriété

TickLabels

TickMarkSpacing

Retourne ou définit le nombre de catégories ou de séries entre les marques de graduation. S’applique uniquement aux axes de catégorie et de séries.

public int TickMarkSpacing { get; set; }

Valeur de la propriété

int

Remarques

Le nombre doit être compris entre 1 et 31999.

Title

Obtient le titre de l’axe.

public Title Title { get; }

Valeur de la propriété

Title

Méthodes

GetAxisTexts()

Obtient les étiquettes de l’axe après avoir appelé la méthode Chart.Calculate().

public string[] GetAxisTexts()

Retourne

string[]

 Français