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
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é
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é
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é
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é
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é
CategoryType
Représente le type d’axe de catégorie.
public CategoryType CategoryType { get; set; }
Valeur de la propriété
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é
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é
CustomDisplayUnit
Spécifie une valeur personnalisée pour l’unité d’affichage.
public double CustomDisplayUnit { get; set; }
Valeur de la propriété
DisplayUnit
Représente l’étiquette d’unité pour l’axe spécifié.
public DisplayUnitType DisplayUnit { get; set; }
Valeur de la propriété
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é
HasMultiLevelLabels
Indique si les étiquettes doivent être affichées comme multi-niveaux.
public bool HasMultiLevelLabels { get; set; }
Valeur de la propriété
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é
IsAutomaticMajorUnit
Indique si l’unité majeure de l’axe est automatiquement assignée.
public bool IsAutomaticMajorUnit { get; set; }
Valeur de la propriété
IsAutomaticMaxValue
Indique si la valeur max est automatiquement assignée.
public bool IsAutomaticMaxValue { get; set; }
Valeur de la propriété
IsAutomaticMinValue
Indique si la valeur min est automatiquement assignée.
public bool IsAutomaticMinValue { get; set; }
Valeur de la propriété
IsAutomaticMinorUnit
Indique si l’unité mineure de l’axe est automatiquement assignée.
public bool IsAutomaticMinorUnit { get; set; }
Valeur de la propriété
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é
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é
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é
IsVisible
Représente si l’axe est visible.
public bool IsVisible { get; set; }
Valeur de la propriété
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é
MajorGridLines
Représente les lignes de grille majeures sur un axe de graphique.
public Line MajorGridLines { get; }
Valeur de la propriété
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é
MajorUnit
Représente les unités majeures pour l’axe.
public double MajorUnit { get; set; }
Valeur de la propriété
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é
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é
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é
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é
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é
MinorUnit
Représente les unités mineures pour l’axe.
public double MinorUnit { get; set; }
Valeur de la propriété
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é
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é
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é
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é
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é
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é
Méthodes
GetAxisTexts()
Obtient les étiquettes de l’axe après avoir appelé la méthode Chart.Calculate().
public string[] GetAxisTexts()
Retourne
string[]