Class Axis

Class Axis

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

封装表示图表轴的对象。

public class Axis

继承

objectAxis

继承成员

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

示例

通过以下代码,您可以学习如何设置轴的单位、最大值和最小值。

//实例化一个 Workbook 对象
Workbook workbook = new Workbook();
//向 Excel 对象添加一个新工作表
int sheetIndex = workbook.Worksheets.Add();
//通过传递工作表索引获取新添加工作表的引用
Worksheet worksheet = workbook.Worksheets[sheetIndex];
//在 "A1" 单元格中添加示例值
worksheet.Cells["A1"].PutValue(50);
//在 "A2" 单元格中添加示例值
worksheet.Cells["A2"].PutValue(100);
//在 "A3" 单元格中添加示例值
worksheet.Cells["A3"].PutValue(150);
//在 "B1" 单元格中添加示例值
worksheet.Cells["B1"].PutValue(4);
//在 "B2" 单元格中添加示例值
worksheet.Cells["B2"].PutValue(20);
//在 "B3" 单元格中添加示例值
worksheet.Cells["B3"].PutValue(50);
//向工作表添加图表
int chartIndex = worksheet.Charts.Add(ChartType.Column, 5, 0, 25, 5);
//访问新添加图表的实例
Chart chart = worksheet.Charts[chartIndex];
//向图表添加 NSeries(图表数据源),范围从 "A1" 单元格到 "B3"
chart.NSeries.Add("A1:B3", true);
//设置值轴的最大值
chart.ValueAxis.MaxValue = 200;
//设置值轴的最小值
chart.ValueAxis.MinValue = 0;
//设置主单位
chart.ValueAxis.MajorUnit = 25;
//类别(X)轴在最大值处交叉。
chart.ValueAxis.CrossType = CrossType.Maximum;
//设置刻度标签之间的类别或系列数量。
chart.CategoryAxis.TickLabelSpacing = 2;

//进行您的业务逻辑

//保存 Excel 文件
workbook.Save("book1.xlsx");
'实例化一个 Workbook 对象
Dim workbook As Workbook = New Workbook()
'向 Excel 对象添加一个新工作表
Dim sheetIndex As Int32 = workbook.Worksheets.Add()
'通过传递工作表索引获取新添加工作表的引用
Dim worksheet As Worksheet = workbook.Worksheets(sheetIndex)
'在 "A1" 单元格中添加示例值
worksheet.Cells("A1").PutValue(50)
'在 "A2" 单元格中添加示例值
worksheet.Cells("A2").PutValue(100)
'在 "A3" 单元格中添加示例值
worksheet.Cells("A3").PutValue(150)
'在 "B1" 单元格中添加示例值
worksheet.Cells("B1").PutValue(4)
'在 "B2" 单元格中添加示例值
worksheet.Cells("B2").PutValue(20)
'在 "B3" 单元格中添加示例值
worksheet.Cells("B3").PutValue(50)
'向工作表添加图表
Dim chartIndex As Int32 = worksheet.Charts.Add(ChartType.Column, 5, 0, 25, 5)
'访问新添加图表的实例
Dim chart As Chart = worksheet.Charts(chartIndex)
'向图表添加 NSeries(图表数据源),范围从 "A1" 单元格到 "B3"
chart.NSeries.Add("A1:B3", True)
'设置值轴的最大值
chart.ValueAxis.MaxValue = 200
'设置值轴的最小值
chart.ValueAxis.MinValue = 0
'设置主单位
chart.ValueAxis.MajorUnit = 25
'类别(X)轴在最大值处交叉。
chart.ValueAxis.CrossType = CrossType.Maximum
'设置刻度标签之间的类别或系列数量。
chart.CategoryAxis.TickLabelSpacing = 2
'保存 Excel 文件
workbook.Save("book1.xlsx")

属性

Area

获取 Aspose.Cells.Charts.Axis.Area。

public Area Area { get; }

属性值

Area

AxisBetweenCategories

表示值轴是否在类别之间交叉类别轴。

public bool AxisBetweenCategories { get; set; }

属性值

bool

备注

此属性仅适用于类别轴,不适用于 3-D 图表。

AxisLine

获取轴的外观。

public Line AxisLine { get; }

属性值

Line

BaseUnitScale

表示类别轴的基本单位刻度。

public TimeUnit BaseUnitScale { get; set; }

属性值

TimeUnit

备注

仅当 CategoryType 属性设置为 TimeScale 时,此属性的设置才生效。

Bins

表示图表(直方图/帕累托)轴上的箱。

public AxisBins Bins { get; }

属性值

AxisBins

CategoryType

表示类别轴类型。

public CategoryType CategoryType { get; set; }

属性值

CategoryType

CrossAt

表示类别轴交叉值轴的点。

public double CrossAt { get; set; }

属性值

double

备注

当适用于类别轴时,数字应为整数。 并且值必须在 1 和 31999 之间。

CrossType

表示指定轴上 Aspose.Cells.Charts.Axis.CrossType 的交叉类型。

public CrossType CrossType { get; set; }

属性值

CrossType

CustomDisplayUnit

指定显示单位的自定义值。

public double CustomDisplayUnit { get; set; }

属性值

double

DisplayUnit

表示指定轴的单位标签。

public DisplayUnitType DisplayUnit { get; set; }

属性值

DisplayUnitType

DisplayUnitLabel

表示指定图表中轴上的单位标签。 单位标签对于表示大型值(例如,数百万或数十亿)非常有用。

public DisplayUnitLabel DisplayUnitLabel { get; }

属性值

DisplayUnitLabel

HasMultiLevelLabels

指示标签是否应显示为多级。

public bool HasMultiLevelLabels { get; set; }

属性值

bool

备注

仅对类别轴有效。

IsAutoTickLabelSpacing

指示刻度标签的间距是否为自动。

public bool IsAutoTickLabelSpacing { get; set; }

属性值

bool

IsAutomaticMajorUnit

指示轴的主单位是否自动分配。

public bool IsAutomaticMajorUnit { get; set; }

属性值

bool

IsAutomaticMaxValue

指示最大值是否自动分配。

public bool IsAutomaticMaxValue { get; set; }

属性值

bool

IsAutomaticMinValue

指示最小值是否自动分配。

public bool IsAutomaticMinValue { get; set; }

属性值

bool

IsAutomaticMinorUnit

指示轴的次单位是否自动分配。

public bool IsAutomaticMinorUnit { get; set; }

属性值

bool

IsDisplayUnitLabelShown

表示指定轴上是否显示显示单位标签。

public bool IsDisplayUnitLabelShown { get; set; }

属性值

bool

备注

默认值为 True。

IsLogarithmic

表示值轴的刻度类型是否为对数。

public bool IsLogarithmic { get; set; }

属性值

bool

IsPlotOrderReversed

表示 Microsoft Excel 是否从最后一个数据点绘制到第一个。

public bool IsPlotOrderReversed { get; set; }

属性值

bool

IsVisible

表示轴是否可见。

public bool IsVisible { get; set; }

属性值

bool

LogBase

表示对数基数。默认值为 10。仅适用于 Excel2007。

public double LogBase { get; set; }

属性值

double

MajorGridLines

表示图表轴上的主要网格线。

public Line MajorGridLines { get; }

属性值

Line

示例

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

MajorTickMark

表示指定轴的主要刻度类型。

public TickMarkType MajorTickMark { get; set; }

属性值

TickMarkType

MajorUnit

表示轴的主要单位。

public double MajorUnit { get; set; }

属性值

double

备注

主要单位必须大于零。

MajorUnitScale

表示类别轴的主要单位刻度。

public TimeUnit MajorUnitScale { get; set; }

属性值

TimeUnit

示例

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

表示值轴上的最大值。

public object MaxValue { get; set; }

属性值

object

备注

maxValue 类型只能是 double 或 DateTime。

MinValue

表示值轴上的最小值。

public object MinValue { get; set; }

属性值

object

备注

minValue 类型只能是 double 或 DateTime。

MinorGridLines

表示图表轴上的次网格线。

public Line MinorGridLines { get; }

属性值

Line

MinorTickMark

表示指定轴的次刻度类型。

public TickMarkType MinorTickMark { get; set; }

属性值

TickMarkType

MinorUnit

表示轴的次单位。

public double MinorUnit { get; set; }

属性值

double

备注

次单位必须大于零。

MinorUnitScale

表示类别轴的主要单位刻度。

public TimeUnit MinorUnitScale { get; set; }

属性值

TimeUnit

示例

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

表示指定轴上刻度标签的位置。

public TickLabelPositionType TickLabelPosition { get; set; }

属性值

TickLabelPositionType

TickLabelSpacing

表示刻度标签之间的类别或系列数量。仅适用于类别和系列轴。

public int TickLabelSpacing { get; set; }

属性值

int

备注

数字必须在 1 和 31999 之间。

TickLabels

返回一个 Aspose.Cells.Charts.Axis.TickLabels 对象,表示指定轴的刻度标签。

public TickLabels TickLabels { get; }

属性值

TickLabels

TickMarkSpacing

返回或设置刻度之间的类别或系列数量。仅适用于类别和系列轴。

public int TickMarkSpacing { get; set; }

属性值

int

备注

数字必须在 1 和 31999 之间。

Title

获取轴的标题。

public Title Title { get; }

属性值

Title

方法

GetAxisTexts()

获取调用 Chart.Calculate() 方法后轴的标签。

public string[] GetAxisTexts()

返回

string[]

 中文