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à
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à
AxisBetweenCategories
Rappresenta se l’asse dei valori incrocia l’asse delle categorie tra le categorie.
public bool AxisBetweenCategories { get; set; }
Valore della Proprietà
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à
BaseUnitScale
Rappresenta la scala dell’unità di base per l’asse delle categorie.
public TimeUnit BaseUnitScale { get; set; }
Valore della Proprietà
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à
CategoryType
Rappresenta il tipo di asse delle categorie.
public CategoryType CategoryType { get; set; }
Valore della Proprietà
CrossAt
Rappresenta il punto sull’asse dei valori dove l’asse delle categorie lo incrocia.
public double CrossAt { get; set; }
Valore della Proprietà
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à
CustomDisplayUnit
Specifica un valore personalizzato per l’unità di visualizzazione.
public double CustomDisplayUnit { get; set; }
Valore della Proprietà
DisplayUnit
Rappresenta l’etichetta dell’unità per l’asse specificato.
public DisplayUnitType DisplayUnit { get; set; }
Valore della Proprietà
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à
HasMultiLevelLabels
Indica se le etichette devono essere visualizzate come multi livello.
public bool HasMultiLevelLabels { get; set; }
Valore della Proprietà
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à
IsAutomaticMajorUnit
Indica se l’unità principale dell’asse è assegnata automaticamente.
public bool IsAutomaticMajorUnit { get; set; }
Valore della Proprietà
IsAutomaticMaxValue
Indica se il valore massimo è assegnato automaticamente.
public bool IsAutomaticMaxValue { get; set; }
Valore della Proprietà
IsAutomaticMinValue
Indica se il valore minimo è assegnato automaticamente.
public bool IsAutomaticMinValue { get; set; }
Valore della Proprietà
IsAutomaticMinorUnit
Indica se l’unità secondaria dell’asse è assegnata automaticamente.
public bool IsAutomaticMinorUnit { get; set; }
Valore della Proprietà
IsDisplayUnitLabelShown
Rappresenta se l’etichetta dell’unità di visualizzazione è mostrata sull’asse specificato.
public bool IsDisplayUnitLabelShown { get; set; }
Valore della Proprietà
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à
IsPlotOrderReversed
Rappresenta se Microsoft Excel rappresenta i punti dati dall’ultimo al primo.
public bool IsPlotOrderReversed { get; set; }
Valore della Proprietà
IsVisible
Rappresenta se l’asse è visibile.
public bool IsVisible { get; set; }
Valore della Proprietà
LogBase
Rappresenta la base logaritmica. Il valore predefinito è 10. Si applica solo per Excel2007.
public double LogBase { get; set; }
Valore della Proprietà
MajorGridLines
Rappresenta le linee della griglia principale su un asse del grafico.
public Line MajorGridLines { get; }
Valore della Proprietà
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à
MajorUnit
Rappresenta le unità principali per l’asse.
public double MajorUnit { get; set; }
Valore della Proprietà
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à
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à
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à
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à
MinorTickMark
Rappresenta il tipo di segno secondario per l’asse specificato.
public TickMarkType MinorTickMark { get; set; }
Valore della Proprietà
MinorUnit
Rappresenta le unità secondarie per l’asse.
public double MinorUnit { get; set; }
Valore della Proprietà
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à
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à
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à
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à
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à
Osservazioni
Il numero deve essere compreso tra 1 e 31999.
Title
Ottiene il titolo dell’asse.
public Title Title { get; }
Valore della Proprietà
Metodi
GetAxisTexts()
Ottiene le etichette dell’asse dopo aver chiamato il metodo Chart.Calculate().
public string[] GetAxisTexts()
Restituisce
string[]