Class Axis
Namespace: Aspose.Cells.Charts
Assembly: Aspose.Cells.dll (25.2.0)
封装表示图表轴的对象。
public class Axis
继承
继承成员
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; }
属性值
AxisBetweenCategories
表示值轴是否在类别之间交叉类别轴。
public bool AxisBetweenCategories { get; set; }
属性值
备注
此属性仅适用于类别轴,不适用于 3-D 图表。
AxisLine
获取轴的外观。
public Line AxisLine { get; }
属性值
BaseUnitScale
表示类别轴的基本单位刻度。
public TimeUnit BaseUnitScale { get; set; }
属性值
备注
仅当 CategoryType 属性设置为 TimeScale 时,此属性的设置才生效。
Bins
表示图表(直方图/帕累托)轴上的箱。
public AxisBins Bins { get; }
属性值
CategoryType
表示类别轴类型。
public CategoryType CategoryType { get; set; }
属性值
CrossAt
表示类别轴交叉值轴的点。
public double CrossAt { get; set; }
属性值
备注
当适用于类别轴时,数字应为整数。 并且值必须在 1 和 31999 之间。
CrossType
表示指定轴上 Aspose.Cells.Charts.Axis.CrossType 的交叉类型。
public CrossType CrossType { get; set; }
属性值
CustomDisplayUnit
指定显示单位的自定义值。
public double CustomDisplayUnit { get; set; }
属性值
DisplayUnit
表示指定轴的单位标签。
public DisplayUnitType DisplayUnit { get; set; }
属性值
DisplayUnitLabel
表示指定图表中轴上的单位标签。 单位标签对于表示大型值(例如,数百万或数十亿)非常有用。
public DisplayUnitLabel DisplayUnitLabel { get; }
属性值
HasMultiLevelLabels
指示标签是否应显示为多级。
public bool HasMultiLevelLabels { get; set; }
属性值
备注
仅对类别轴有效。
IsAutoTickLabelSpacing
指示刻度标签的间距是否为自动。
public bool IsAutoTickLabelSpacing { get; set; }
属性值
IsAutomaticMajorUnit
指示轴的主单位是否自动分配。
public bool IsAutomaticMajorUnit { get; set; }
属性值
IsAutomaticMaxValue
指示最大值是否自动分配。
public bool IsAutomaticMaxValue { get; set; }
属性值
IsAutomaticMinValue
指示最小值是否自动分配。
public bool IsAutomaticMinValue { get; set; }
属性值
IsAutomaticMinorUnit
指示轴的次单位是否自动分配。
public bool IsAutomaticMinorUnit { get; set; }
属性值
IsDisplayUnitLabelShown
表示指定轴上是否显示显示单位标签。
public bool IsDisplayUnitLabelShown { get; set; }
属性值
备注
默认值为 True。
IsLogarithmic
表示值轴的刻度类型是否为对数。
public bool IsLogarithmic { get; set; }
属性值
IsPlotOrderReversed
表示 Microsoft Excel 是否从最后一个数据点绘制到第一个。
public bool IsPlotOrderReversed { get; set; }
属性值
IsVisible
表示轴是否可见。
public bool IsVisible { get; set; }
属性值
LogBase
表示对数基数。默认值为 10。仅适用于 Excel2007。
public double LogBase { get; set; }
属性值
MajorGridLines
表示图表轴上的主要网格线。
public Line MajorGridLines { get; }
属性值
示例
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; }
属性值
MajorUnit
表示轴的主要单位。
public double MajorUnit { get; set; }
属性值
备注
主要单位必须大于零。
MajorUnitScale
表示类别轴的主要单位刻度。
public TimeUnit MajorUnitScale { get; set; }
属性值
示例
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; }
属性值
备注
maxValue 类型只能是 double 或 DateTime。
MinValue
表示值轴上的最小值。
public object MinValue { get; set; }
属性值
备注
minValue 类型只能是 double 或 DateTime。
MinorGridLines
表示图表轴上的次网格线。
public Line MinorGridLines { get; }
属性值
MinorTickMark
表示指定轴的次刻度类型。
public TickMarkType MinorTickMark { get; set; }
属性值
MinorUnit
表示轴的次单位。
public double MinorUnit { get; set; }
属性值
备注
次单位必须大于零。
MinorUnitScale
表示类别轴的主要单位刻度。
public TimeUnit MinorUnitScale { get; set; }
属性值
示例
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; }
属性值
TickLabelSpacing
表示刻度标签之间的类别或系列数量。仅适用于类别和系列轴。
public int TickLabelSpacing { get; set; }
属性值
备注
数字必须在 1 和 31999 之间。
TickLabels
返回一个 Aspose.Cells.Charts.Axis.TickLabels 对象,表示指定轴的刻度标签。
public TickLabels TickLabels { get; }
属性值
TickMarkSpacing
返回或设置刻度之间的类别或系列数量。仅适用于类别和系列轴。
public int TickMarkSpacing { get; set; }
属性值
备注
数字必须在 1 和 31999 之间。
Title
获取轴的标题。
public Title Title { get; }
属性值
方法
GetAxisTexts()
获取调用 Chart.Calculate() 方法后轴的标签。
public string[] GetAxisTexts()
返回
string[]