Class Axis

Class Axis

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

Incapsula l’oggetto che rappresenta un’asse del grafico.

public class Axis

Ereditarietà

objectAxis

Membri Ereditati

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

Esempi

Dai seguenti codici, puoi imparare come impostare l’unità, il valore massimo e minimo dell’asse.

//Instanziando un oggetto Workbook
Workbook workbook = new Workbook();
//Aggiungendo un nuovo foglio di lavoro all'oggetto Excel
int sheetIndex = workbook.Worksheets.Add();
//Ottenendo il riferimento del foglio di lavoro appena aggiunto passando il suo indice
Worksheet worksheet = workbook.Worksheets[sheetIndex];
//Aggiungendo un valore di esempio alla cella "A1"
worksheet.Cells["A1"].PutValue(50);
//Aggiungendo un valore di esempio alla cella "A2"
worksheet.Cells["A2"].PutValue(100);
//Aggiungendo un valore di esempio alla cella "A3"
worksheet.Cells["A3"].PutValue(150);
//Aggiungendo un valore di esempio alla cella "B1"
worksheet.Cells["B1"].PutValue(4);
//Aggiungendo un valore di esempio alla cella "B2"
worksheet.Cells["B2"].PutValue(20);
//Aggiungendo un valore di esempio alla cella "B3"
worksheet.Cells["B3"].PutValue(50);
//Aggiungendo un grafico al foglio di lavoro
int chartIndex = worksheet.Charts.Add(ChartType.Column, 5, 0, 25, 5);
//Accedendo all'istanza del grafico appena aggiunto
Chart chart = worksheet.Charts[chartIndex];
//Aggiungendo NSeries (sorgente dati del grafico) al grafico che va dalla cella "A1" alla "B3"
chart.NSeries.Add("A1:B3", true);
//Imposta il valore massimo dell'asse dei valori
chart.ValueAxis.MaxValue = 200;
//Imposta il valore minimo dell'asse dei valori
chart.ValueAxis.MinValue = 0;
//Imposta l'unità principale
chart.ValueAxis.MajorUnit = 25;
//L'asse delle categorie (X) incrocia al valore massimo.
chart.ValueAxis.CrossType = CrossType.Maximum;
//Imposta il numero di categorie o serie tra le etichette dei segni di spunta. 
chart.CategoryAxis.TickLabelSpacing = 2;

//fai il tuo lavoro

//Salvando il file Excel
workbook.Save("book1.xlsx");
'Instanziando un oggetto Workbook
Dim workbook As Workbook = New Workbook()
'Aggiungendo un nuovo foglio di lavoro all'oggetto Excel
Dim sheetIndex As Int32 = workbook.Worksheets.Add()
'Ottenendo il riferimento del foglio di lavoro appena aggiunto passando il suo indice
Dim worksheet As Worksheet = workbook.Worksheets(sheetIndex)
'Aggiungendo un valore di esempio alla cella "A1"
worksheet.Cells("A1").PutValue(50)
'Aggiungendo un valore di esempio alla cella "A2"
worksheet.Cells("A2").PutValue(100)
'Aggiungendo un valore di esempio alla cella "A3"
worksheet.Cells("A3").PutValue(150)
'Aggiungendo un valore di esempio alla cella "B1"
worksheet.Cells("B1").PutValue(4)
'Aggiungendo un valore di esempio alla cella "B2"
worksheet.Cells("B2").PutValue(20)
'Aggiungendo un valore di esempio alla cella "B3"
worksheet.Cells("B3").PutValue(50)
'Aggiungendo un grafico al foglio di lavoro
Dim chartIndex As Int32 = worksheet.Charts.Add(ChartType.Column, 5, 0, 25, 5)
'Accedendo all'istanza del grafico appena aggiunto
Dim chart As Chart = worksheet.Charts(chartIndex)
'Aggiungendo NSeries (sorgente dati del grafico) al grafico che va dalla cella "A1" alla "B3"
chart.NSeries.Add("A1:B3", True)
'Imposta il valore massimo dell'asse dei valori
chart.ValueAxis.MaxValue = 200
'Imposta il valore minimo dell'asse dei valori
chart.ValueAxis.MinValue = 0
'Imposta l'unità principale
chart.ValueAxis.MajorUnit = 25
'L'asse delle categorie (X) incrocia al valore massimo.
chart.ValueAxis.CrossType = CrossType.Maximum
'Imposta il numero di categorie o serie tra le etichette dei segni di spunta. 
chart.CategoryAxis.TickLabelSpacing = 2
'Saving the Excel file
workbook.Save("book1.xlsx")

Proprietà

Area

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

public Area Area { get; }

Valore della Proprietà

Area

AxisBetweenCategories

Rappresenta se l’asse dei valori incrocia l’asse delle categorie tra le categorie.

public bool AxisBetweenCategories { get; set; }

Valore della Proprietà

bool

Osservazioni

Questa proprietà si applica solo agli assi delle categorie e non si applica ai grafici 3-D.

AxisLine

Ottiene l’aspetto di un asse.

public Line AxisLine { get; }

Valore della Proprietà

Line

BaseUnitScale

Rappresenta la scala dell’unità di base per l’asse delle categorie.

public TimeUnit BaseUnitScale { get; set; }

Valore della Proprietà

TimeUnit

Osservazioni

Impostare questa proprietà ha effetto solo quando la proprietà CategoryType è impostata su TimeScale.

Bins

Rappresenta i bin su un asse di grafico (Istogramma/Pareto)

public AxisBins Bins { get; }

Valore della Proprietà

AxisBins

CategoryType

Rappresenta il tipo di asse delle categorie.

public CategoryType CategoryType { get; set; }

Valore della Proprietà

CategoryType

CrossAt

Rappresenta il punto sull’asse dei valori dove l’asse delle categorie lo incrocia.

public double CrossAt { get; set; }

Valore della Proprietà

double

Osservazioni

Il numero deve essere un intero quando si applica all’asse delle categorie. E il valore deve essere compreso tra 1 e 31999.

CrossType

Rappresenta l’Aspose.Cells.Charts.Axis.CrossType sull’asse specificato dove l’altro asse incrocia.

public CrossType CrossType { get; set; }

Valore della Proprietà

CrossType

CustomDisplayUnit

Specifica un valore personalizzato per l’unità di visualizzazione.

public double CustomDisplayUnit { get; set; }

Valore della Proprietà

double

DisplayUnit

Rappresenta l’etichetta dell’unità per l’asse specificato.

public DisplayUnitType DisplayUnit { get; set; }

Valore della Proprietà

DisplayUnitType

DisplayUnitLabel

Rappresenta un’etichetta dell’unità su un asse nel grafico specificato. Le etichette delle unità sono utili per rappresentare valori grandi, ad esempio, in milioni o miliardi.

public DisplayUnitLabel DisplayUnitLabel { get; }

Valore della Proprietà

DisplayUnitLabel

HasMultiLevelLabels

Indica se le etichette devono essere visualizzate come multi livello.

public bool HasMultiLevelLabels { get; set; }

Valore della Proprietà

bool

Osservazioni

Valido solo per l’asse delle categorie.

IsAutoTickLabelSpacing

Indica se il spacing delle etichette dei segni di spunta è automatico

public bool IsAutoTickLabelSpacing { get; set; }

Valore della Proprietà

bool

IsAutomaticMajorUnit

Indica se l’unità principale dell’asse è assegnata automaticamente.

public bool IsAutomaticMajorUnit { get; set; }

Valore della Proprietà

bool

IsAutomaticMaxValue

Indica se il valore massimo è assegnato automaticamente.

public bool IsAutomaticMaxValue { get; set; }

Valore della Proprietà

bool

IsAutomaticMinValue

Indica se il valore minimo è assegnato automaticamente.

public bool IsAutomaticMinValue { get; set; }

Valore della Proprietà

bool

IsAutomaticMinorUnit

Indica se l’unità secondaria dell’asse è assegnata automaticamente.

public bool IsAutomaticMinorUnit { get; set; }

Valore della Proprietà

bool

IsDisplayUnitLabelShown

Rappresenta se l’etichetta dell’unità di visualizzazione è mostrata sull’asse specificato.

public bool IsDisplayUnitLabelShown { get; set; }

Valore della Proprietà

bool

Osservazioni

Il valore predefinito è True.

IsLogarithmic

Rappresenta se il tipo di scala dell’asse dei valori è logaritmico o meno.

public bool IsLogarithmic { get; set; }

Valore della Proprietà

bool

IsPlotOrderReversed

Rappresenta se Microsoft Excel rappresenta i punti dati dall’ultimo al primo.

public bool IsPlotOrderReversed { get; set; }

Valore della Proprietà

bool

IsVisible

Rappresenta se l’asse è visibile.

public bool IsVisible { get; set; }

Valore della Proprietà

bool

LogBase

Rappresenta la base logaritmica. Il valore predefinito è 10. Si applica solo per Excel2007.

public double LogBase { get; set; }

Valore della Proprietà

double

MajorGridLines

Rappresenta le linee della griglia principale su un asse del grafico.

public Line MajorGridLines { get; }

Valore della Proprietà

Line

Esempi

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

MajorTickMark

Rappresenta il tipo di segno principale per l’asse specificato.

public TickMarkType MajorTickMark { get; set; }

Valore della Proprietà

TickMarkType

MajorUnit

Rappresenta le unità principali per l’asse.

public double MajorUnit { get; set; }

Valore della Proprietà

double

Osservazioni

Le unità principali devono essere maggiori di zero.

MajorUnitScale

Rappresenta la scala dell’unità principale per l’asse delle categorie.

public TimeUnit MajorUnitScale { get; set; }

Valore della Proprietà

TimeUnit

Esempi

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

Rappresenta il valore massimo sull’asse dei valori.

public object MaxValue { get; set; }

Valore della Proprietà

object

Osservazioni

Il tipo maxValue può essere solo double o DateTime

MinValue

Rappresenta il valore minimo sull’asse dei valori.

public object MinValue { get; set; }

Valore della Proprietà

object

Osservazioni

Il tipo minValue può essere solo double o DateTime

MinorGridLines

Rappresenta le linee della griglia secondaria su un asse del grafico.

public Line MinorGridLines { get; }

Valore della Proprietà

Line

MinorTickMark

Rappresenta il tipo di segno secondario per l’asse specificato.

public TickMarkType MinorTickMark { get; set; }

Valore della Proprietà

TickMarkType

MinorUnit

Rappresenta le unità secondarie per l’asse.

public double MinorUnit { get; set; }

Valore della Proprietà

double

Osservazioni

Le unità secondarie devono essere maggiori di zero.

MinorUnitScale

Rappresenta la scala dell’unità principale per l’asse delle categorie.

public TimeUnit MinorUnitScale { get; set; }

Valore della Proprietà

TimeUnit

Esempi

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

Rappresenta la posizione delle etichette dei segni di spunta sull’asse specificato.

public TickLabelPositionType TickLabelPosition { get; set; }

Valore della Proprietà

TickLabelPositionType

TickLabelSpacing

Rappresenta il numero di categorie o serie tra le etichette dei segni di spunta. Si applica solo agli assi delle categorie e delle serie.

public int TickLabelSpacing { get; set; }

Valore della Proprietà

int

Osservazioni

Il numero deve essere compreso tra 1 e 31999.

TickLabels

Restituisce un oggetto Aspose.Cells.Charts.Axis.TickLabels che rappresenta le etichette dei segni di spunta per l’asse specificato.

public TickLabels TickLabels { get; }

Valore della Proprietà

TickLabels

TickMarkSpacing

Restituisce o imposta il numero di categorie o serie tra i segni di spunta. Si applica solo agli assi delle categorie e delle serie.

public int TickMarkSpacing { get; set; }

Valore della Proprietà

int

Osservazioni

Il numero deve essere compreso tra 1 e 31999.

Title

Ottiene il titolo dell’asse.

public Title Title { get; }

Valore della Proprietà

Title

Metodi

GetAxisTexts()

Ottiene le etichette dell’asse dopo aver chiamato il metodo Chart.Calculate().

public string[] GetAxisTexts()

Restituisce

string[]

 Italiano