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 property 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.
// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET | |
// The path to the documents directory. | |
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType); | |
// Create directory if it is not already present. | |
bool IsExists = System.IO.Directory.Exists(dataDir); | |
if (!IsExists) | |
System.IO.Directory.CreateDirectory(dataDir); | |
// Instantiating a Workbook object | |
Workbook workbook = new Workbook(); | |
// Adding a new worksheet to the Workbook object | |
int sheetIndex = workbook.Worksheets.Add(); | |
// Obtaining the reference of the newly added worksheet by passing its sheet index | |
Worksheet worksheet = workbook.Worksheets[sheetIndex]; | |
// Adding sample values to cells | |
worksheet.Cells["A1"].PutValue(50); | |
worksheet.Cells["A2"].PutValue(100); | |
worksheet.Cells["A3"].PutValue(150); | |
worksheet.Cells["B1"].PutValue(60); | |
worksheet.Cells["B2"].PutValue(32); | |
worksheet.Cells["B3"].PutValue(50); | |
// Adding a chart to the worksheet | |
int chartIndex = worksheet.Charts.Add(Aspose.Cells.Charts.ChartType.Column, 5, 0, 15, 5); | |
// Accessing the instance of the newly added chart | |
Aspose.Cells.Charts.Chart chart = worksheet.Charts[chartIndex]; | |
// Adding SeriesCollection (chart data source) to the chart ranging from "A1" cell to "B3" | |
chart.NSeries.Add("A1:B3", true); | |
// Setting the foreground color of the plot area | |
chart.PlotArea.Area.ForegroundColor = Color.Blue; | |
// Setting the foreground color of the chart area | |
chart.ChartArea.Area.ForegroundColor = Color.Yellow; | |
// Setting the foreground color of the 1st SeriesCollection area | |
chart.NSeries[0].Area.ForegroundColor = Color.Red; | |
// Setting the foreground color of the area of the 1st SeriesCollection point | |
chart.NSeries[0].Points[0].Area.ForegroundColor = Color.Cyan; | |
// Filling the area of the 2nd SeriesCollection with a gradient | |
chart.NSeries[1].Area.FillFormat.SetOneColorGradient(Color.Lime, 1, Aspose.Cells.Drawing.GradientStyleType.Horizontal, 1); | |
// Setting the title of a chart | |
chart.Title.Text = "Title"; | |
// Setting the font color of the chart title to blue | |
chart.Title.Font.Color = Color.Blue; | |
// Setting the title of category axis of the chart | |
chart.CategoryAxis.Title.Text = "Category"; | |
// Setting the title of value axis of the chart | |
chart.ValueAxis.Title.Text = "Value"; | |
// Saving the Excel file | |
workbook.Save(dataDir + "book1.out.xls"); |