Class Axis

Class Axis

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

Encapsuluje obiekt, który reprezentuje oś wykresu.

public class Axis

Dziedziczenie

objectAxis

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

Area

AxisBetweenCategories

Reprezentuje, czy oś wartości przecina oś kategorii między kategoriami.

public bool AxisBetweenCategories { get; set; }

Wartość właściwości

bool

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

Line

BaseUnitScale

Reprezentuje skalę jednostki podstawowej dla osi kategorii.

public TimeUnit BaseUnitScale { get; set; }

Wartość właściwości

TimeUnit

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

AxisBins

CategoryType

Reprezentuje typ osi kategorii.

public CategoryType CategoryType { get; set; }

Wartość właściwości

CategoryType

CrossAt

Reprezentuje punkt na osi wartości, w którym oś kategorii ją przecina.

public double CrossAt { get; set; }

Wartość właściwości

double

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

CrossType

CustomDisplayUnit

Określa niestandardową wartość dla jednostki wyświetlania.

public double CustomDisplayUnit { get; set; }

Wartość właściwości

double

DisplayUnit

Reprezentuje etykietę jednostki dla określonej osi.

public DisplayUnitType DisplayUnit { get; set; }

Wartość właściwości

DisplayUnitType

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

DisplayUnitLabel

HasMultiLevelLabels

Wskazuje, czy etykiety mają być wyświetlane jako wielopoziomowe.

public bool HasMultiLevelLabels { get; set; }

Wartość właściwości

bool

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

bool

IsAutomaticMajorUnit

Wskazuje, czy główna jednostka osi jest automatycznie przypisywana.

public bool IsAutomaticMajorUnit { get; set; }

Wartość właściwości

bool

IsAutomaticMaxValue

Wskazuje, czy maksymalna wartość jest automatycznie przypisywana.

public bool IsAutomaticMaxValue { get; set; }

Wartość właściwości

bool

IsAutomaticMinValue

Wskazuje, czy minimalna wartość jest automatycznie przypisywana.

public bool IsAutomaticMinValue { get; set; }

Wartość właściwości

bool

IsAutomaticMinorUnit

Wskazuje, czy mniejsza jednostka osi jest automatycznie przypisywana.

public bool IsAutomaticMinorUnit { get; set; }

Wartość właściwości

bool

IsDisplayUnitLabelShown

Reprezentuje, czy etykieta jednostki wyświetlania jest pokazana na określonej osi.

public bool IsDisplayUnitLabelShown { get; set; }

Wartość właściwości

bool

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

bool

IsPlotOrderReversed

Reprezentuje, czy Microsoft Excel rysuje punkty danych od ostatniego do pierwszego.

public bool IsPlotOrderReversed { get; set; }

Wartość właściwości

bool

IsVisible

Reprezentuje, czy oś jest widoczna.

public bool IsVisible { get; set; }

Wartość właściwości

bool

LogBase

Reprezentuje podstawę logarytmu. Wartość domyślna to 10. Dotyczy tylko Excel2007.

public double LogBase { get; set; }

Wartość właściwości

double

MajorGridLines

Reprezentuje główne linie siatki na osi wykresu.

public Line MajorGridLines { get; }

Wartość właściwości

Line

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

TickMarkType

MajorUnit

Reprezentuje główne jednostki dla osi.

public double MajorUnit { get; set; }

Wartość właściwości

double

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

TimeUnit

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

object

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

object

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

Line

MinorTickMark

Reprezentuje typ mniejszej etykiety tick dla określonej osi.

public TickMarkType MinorTickMark { get; set; }

Wartość właściwości

TickMarkType

MinorUnit

Reprezentuje mniejsze jednostki dla osi.

public double MinorUnit { get; set; }

Wartość właściwości

double

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

TimeUnit

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

TickLabelPositionType

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

int

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

TickLabels

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

int

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

Title

Metody

GetAxisTexts()

Uzyskuje etykiety osi po wywołaniu metody Chart.Calculate().

public string[] GetAxisTexts()

Zwraca

string[]

 Polski