Class Axis
Namespace: Aspose.Cells.Charts
Assembly: Aspose.Cells.dll (25.2.0)
Encapsuluje obiekt, który reprezentuje oś wykresu.
public class Axis
Dziedziczenie
Członkowie dziedziczeni
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Przykłady
Z poniższych kodów możesz dowiedzieć się, jak ustawić jednostkę, maksymalną i minimalną wartość osi.
//Tworzenie obiektu Workbook
Workbook workbook = new Workbook();
//Dodawanie nowego arkusza do obiektu Excel
int sheetIndex = workbook.Worksheets.Add();
//Uzyskiwanie odniesienia do nowo dodanego arkusza, przekazując jego indeks
Worksheet worksheet = workbook.Worksheets[sheetIndex];
//Dodawanie przykładowej wartości do komórki "A1"
worksheet.Cells["A1"].PutValue(50);
//Dodawanie przykładowej wartości do komórki "A2"
worksheet.Cells["A2"].PutValue(100);
//Dodawanie przykładowej wartości do komórki "A3"
worksheet.Cells["A3"].PutValue(150);
//Dodawanie przykładowej wartości do komórki "B1"
worksheet.Cells["B1"].PutValue(4);
//Dodawanie przykładowej wartości do komórki "B2"
worksheet.Cells["B2"].PutValue(20);
//Dodawanie przykładowej wartości do komórki "B3"
worksheet.Cells["B3"].PutValue(50);
//Dodawanie wykresu do arkusza
int chartIndex = worksheet.Charts.Add(ChartType.Column, 5, 0, 25, 5);
//Uzyskiwanie instancji nowo dodanego wykresu
Chart chart = worksheet.Charts[chartIndex];
//Dodawanie NSeries (źródło danych wykresu) do wykresu w zakresie od komórki "A1" do "B3"
chart.NSeries.Add("A1:B3", true);
//Ustawianie maksymalnej wartości osi wartości
chart.ValueAxis.MaxValue = 200;
//Ustawianie minimalnej wartości osi wartości
chart.ValueAxis.MinValue = 0;
//Ustawianie jednostki głównej
chart.ValueAxis.MajorUnit = 25;
//Oś kategorii (X) przecina się przy maksymalnej wartości.
chart.ValueAxis.CrossType = CrossType.Maximum;
//Ustawianie liczby kategorii lub serii między etykietami tick-mark.
chart.CategoryAxis.TickLabelSpacing = 2;
//wykonaj swoje operacje
//Zapis pliku Excel
workbook.Save("book1.xlsx");
'Tworzenie obiektu Workbook
Dim workbook As Workbook = New Workbook()
'Dodawanie nowego arkusza do obiektu Excel
Dim sheetIndex As Int32 = workbook.Worksheets.Add()
'Uzyskiwanie odniesienia do nowo dodanego arkusza, przekazując jego indeks
Dim worksheet As Worksheet = workbook.Worksheets(sheetIndex)
'Dodawanie przykładowej wartości do komórki "A1"
worksheet.Cells("A1").PutValue(50)
'Dodawanie przykładowej wartości do komórki "A2"
worksheet.Cells("A2").PutValue(100)
'Dodawanie przykładowej wartości do komórki "A3"
worksheet.Cells("A3").PutValue(150)
'Dodawanie przykładowej wartości do komórki "B1"
worksheet.Cells("B1").PutValue(4)
'Dodawanie przykładowej wartości do komórki "B2"
worksheet.Cells("B2").PutValue(20)
'Dodawanie przykładowej wartości do komórki "B3"
worksheet.Cells("B3").PutValue(50)
'Dodawanie wykresu do arkusza
Dim chartIndex As Int32 = worksheet.Charts.Add(ChartType.Column, 5, 0, 25, 5)
'Uzyskiwanie instancji nowo dodanego wykresu
Dim chart As Chart = worksheet.Charts(chartIndex)
'Dodawanie NSeries (źródło danych wykresu) do wykresu w zakresie od komórki "A1" do "B3"
chart.NSeries.Add("A1:B3", True)
'Ustawianie maksymalnej wartości osi wartości
chart.ValueAxis.MaxValue = 200
'Ustawianie minimalnej wartości osi wartości
chart.ValueAxis.MinValue = 0
'Ustawianie jednostki głównej
chart.ValueAxis.MajorUnit = 25
'Oś kategorii (X) przecina się przy maksymalnej wartości.
chart.ValueAxis.CrossType = CrossType.Maximum
'Ustawianie liczby kategorii lub serii między etykietami tick-mark.
chart.CategoryAxis.TickLabelSpacing = 2
'Zapis pliku Excel
workbook.Save("book1.xlsx")
Właściwości
Area
Uzyskuje Aspose.Cells.Charts.Axis.Area.
public Area Area { get; }
Wartość właściwości
AxisBetweenCategories
Reprezentuje, czy oś wartości przecina oś kategorii między kategoriami.
public bool AxisBetweenCategories { get; set; }
Wartość właściwości
Uwagi
Ta właściwość dotyczy tylko osi kategorii i nie dotyczy wykresów 3D.
AxisLine
Uzyskuje wygląd osi.
public Line AxisLine { get; }
Wartość właściwości
BaseUnitScale
Reprezentuje skalę jednostki podstawowej dla osi kategorii.
public TimeUnit BaseUnitScale { get; set; }
Wartość właściwości
Uwagi
Ustawienie tej właściwości ma zastosowanie tylko wtedy, gdy właściwość CategoryType jest ustawiona na TimeScale.
Bins
Reprezentuje pojemniki na osi wykresu (Histogram/Pareto).
public AxisBins Bins { get; }
Wartość właściwości
CategoryType
Reprezentuje typ osi kategorii.
public CategoryType CategoryType { get; set; }
Wartość właściwości
CrossAt
Reprezentuje punkt na osi wartości, w którym oś kategorii ją przecina.
public double CrossAt { get; set; }
Wartość właściwości
Uwagi
Liczba powinna być liczbą całkowitą, gdy dotyczy osi kategorii. A wartość musi mieścić się w przedziale od 1 do 31999.
CrossType
Reprezentuje Aspose.Cells.Charts.Axis.CrossType na określonej osi, gdzie przecina się inna oś.
public CrossType CrossType { get; set; }
Wartość właściwości
CustomDisplayUnit
Określa niestandardową wartość dla jednostki wyświetlania.
public double CustomDisplayUnit { get; set; }
Wartość właściwości
DisplayUnit
Reprezentuje etykietę jednostki dla określonej osi.
public DisplayUnitType DisplayUnit { get; set; }
Wartość właściwości
DisplayUnitLabel
Reprezentuje etykietę jednostki na osi w określonym wykresie. Etykiety jednostek są przydatne do wykresów dużych wartości — na przykład w milionach lub miliardach.
public DisplayUnitLabel DisplayUnitLabel { get; }
Wartość właściwości
HasMultiLevelLabels
Wskazuje, czy etykiety mają być wyświetlane jako wielopoziomowe.
public bool HasMultiLevelLabels { get; set; }
Wartość właściwości
Uwagi
Tylko ważne dla osi kategorii.
IsAutoTickLabelSpacing
Wskazuje, czy odstępy etykiet tick są automatyczne.
public bool IsAutoTickLabelSpacing { get; set; }
Wartość właściwości
IsAutomaticMajorUnit
Wskazuje, czy główna jednostka osi jest automatycznie przypisywana.
public bool IsAutomaticMajorUnit { get; set; }
Wartość właściwości
IsAutomaticMaxValue
Wskazuje, czy maksymalna wartość jest automatycznie przypisywana.
public bool IsAutomaticMaxValue { get; set; }
Wartość właściwości
IsAutomaticMinValue
Wskazuje, czy minimalna wartość jest automatycznie przypisywana.
public bool IsAutomaticMinValue { get; set; }
Wartość właściwości
IsAutomaticMinorUnit
Wskazuje, czy mniejsza jednostka osi jest automatycznie przypisywana.
public bool IsAutomaticMinorUnit { get; set; }
Wartość właściwości
IsDisplayUnitLabelShown
Reprezentuje, czy etykieta jednostki wyświetlania jest pokazana na określonej osi.
public bool IsDisplayUnitLabelShown { get; set; }
Wartość właściwości
Uwagi
Wartość domyślna to True.
IsLogarithmic
Reprezentuje, czy typ skali osi wartości jest logarytmiczny, czy nie.
public bool IsLogarithmic { get; set; }
Wartość właściwości
IsPlotOrderReversed
Reprezentuje, czy Microsoft Excel rysuje punkty danych od ostatniego do pierwszego.
public bool IsPlotOrderReversed { get; set; }
Wartość właściwości
IsVisible
Reprezentuje, czy oś jest widoczna.
public bool IsVisible { get; set; }
Wartość właściwości
LogBase
Reprezentuje podstawę logarytmu. Wartość domyślna to 10. Dotyczy tylko Excel2007.
public double LogBase { get; set; }
Wartość właściwości
MajorGridLines
Reprezentuje główne linie siatki na osi wykresu.
public Line MajorGridLines { get; }
Wartość właściwości
Przykłady
chart.ValueAxis.MajorGridLines.IsVisible = false;
chart.CategoryAxis.MajorGridLines.IsVisible = true;
chart.ValueAxis.MajorGridLines.IsVisible = false
chart.CategoryAxis.MajorGridLines.IsVisible = true
MajorTickMark
Reprezentuje typ głównej etykiety tick dla określonej osi.
public TickMarkType MajorTickMark { get; set; }
Wartość właściwości
MajorUnit
Reprezentuje główne jednostki dla osi.
public double MajorUnit { get; set; }
Wartość właściwości
Uwagi
Główne jednostki muszą być większe od zera.
MajorUnitScale
Reprezentuje główną jednostkę skali dla osi kategorii.
public TimeUnit MajorUnitScale { get; set; }
Wartość właściwości
Przykłady
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
Reprezentuje maksymalną wartość na osi wartości.
public object MaxValue { get; set; }
Wartość właściwości
Uwagi
Typ maxValue może być tylko double lub DateTime.
MinValue
Reprezentuje minimalną wartość na osi wartości.
public object MinValue { get; set; }
Wartość właściwości
Uwagi
Typ minValue może być tylko double lub DateTime.
MinorGridLines
Reprezentuje mniejsze linie siatki na osi wykresu.
public Line MinorGridLines { get; }
Wartość właściwości
MinorTickMark
Reprezentuje typ mniejszej etykiety tick dla określonej osi.
public TickMarkType MinorTickMark { get; set; }
Wartość właściwości
MinorUnit
Reprezentuje mniejsze jednostki dla osi.
public double MinorUnit { get; set; }
Wartość właściwości
Uwagi
Mniejsze jednostki muszą być większe od zera.
MinorUnitScale
Reprezentuje mniejszą jednostkę skali dla osi kategorii.
public TimeUnit MinorUnitScale { get; set; }
Wartość właściwości
Przykłady
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
Reprezentuje pozycję etykiet tick-mark na określonej osi.
public TickLabelPositionType TickLabelPosition { get; set; }
Wartość właściwości
TickLabelSpacing
Reprezentuje liczbę kategorii lub serii między etykietami tick-mark. Dotyczy tylko osi kategorii i serii.
public int TickLabelSpacing { get; set; }
Wartość właściwości
Uwagi
Liczba musi mieścić się w przedziale od 1 do 31999.
TickLabels
Zwraca obiekt Aspose.Cells.Charts.Axis.TickLabels, który reprezentuje etykiety tick-mark dla określonej osi.
public TickLabels TickLabels { get; }
Wartość właściwości
TickMarkSpacing
Zwraca lub ustawia liczbę kategorii lub serii między etykietami tick. Dotyczy tylko osi kategorii i serii.
public int TickMarkSpacing { get; set; }
Wartość właściwości
Uwagi
Liczba musi mieścić się w przedziale od 1 do 31999.
Title
Uzyskuje tytuł osi.
public Title Title { get; }
Wartość właściwości
Metody
GetAxisTexts()
Uzyskuje etykiety osi po wywołaniu metody Chart.Calculate().
public string[] GetAxisTexts()
Zwraca
string[]