Manage Axes of Excel Charts

Axis Options

Aspose.Cells also allows to manage chart’s axes at runtime,with Axis object, you can change all options of Axis as done in Excel.

|todo:image_alt_text|

Manage X and Y Axes

In Excel chart, horizonal and vertical axes are the two most popular axes to use.

The following code snippet demonstrates how to set the options of X and Y axes .

// Instantiating a Workbook object
Workbook workbook = new Workbook();
// Adding a new worksheet to the Workbook object
int sheetIndex = workbook.getWorksheets().add();
// Obtaining the reference of the newly added worksheet by passing its sheet index
Worksheet worksheet = workbook.getWorksheets().get(sheetIndex);
// Adding sample values to cells
worksheet.getCells().get("A1").putValue("Series1");
worksheet.getCells().get("A2").putValue(50);
worksheet.getCells().get("A3").putValue(100);
worksheet.getCells().get("A4").putValue(150);
worksheet.getCells().get("B1").putValue("Series2");
worksheet.getCells().get("B2").putValue(60);
worksheet.getCells().get("B3").putValue(32);
worksheet.getCells().get("B4").putValue(50);
// Adding a chart to the worksheet
int chartIndex = worksheet.getCharts().add(ChartType.COLUMN, 5, 0, 15, 5);
// Accessing the instance of the newly added chart
Chart chart = worksheet.getCharts().get(chartIndex);
// Adding SeriesCollection (chart data source) to the chart ranging from "A1" cell to "B3"
chart.setChartDataRange("A1:B4",true);
//hiding X axis
chart.getCategoryAxis().setVisible(false);
// Setting max value of Y axis.
chart.getValueAxis().setMaxValue(200);
// Setting major unit.
chart.getValueAxis().setMajorUnit(50);
// Save the file
workbook.save("chart_axes.xlsx");

Advance topics

  • Change Tick Label Direction
  • Determine which Axis exists in the Chart
  • Handle Automatic Units of Chart Axis like Microsoft Excel