Manage Titles of Excel Charts
In Excel charts, there are 2 kinds of title:
- Chart Title
- Axis Titles
Title Options
Aspose.Cells also allows to manage chart’s titles at runtime,with Title object, you can change text, font and fill format for titles.
||
Setting the Titles of Charts or Axes
You can use Microsoft Excel to set the titles of a chart and its axes in a WYSIWYG environment. Aspose.Cells also allows developers to set the titles of a chart and its axes at runtime. All charts and their axes contain a Title object that can be used to set their titles as shown below in an example.
The following code snippet demonstrates how to set titles to charts and 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.getNSeries().add("A1:B3", true); | |
// Setting the title of a chart | |
chart.getTitle().setText("Title"); | |
// Setting the font color of the chart title to blue | |
chart.getTitle().getFont().setColor( Color.getBlue()); | |
// Setting the title of category axis of the chart | |
chart.getCategoryAxis().getTitle().setText ("Category"); | |
// Setting the title of value axis of the chart | |
chart.getValueAxis().getTitle().setText ( "Value"); | |
// Save the file | |
workbook.save("chart_datalabels.xlsx"); |