How to change line style in line chart using WinForms XlsIO?
This article explains how to change the line style to a smoothed line in a line chart using XlsIO.
What is a smoothed line?
A smoothed line helps you explore the potential relationships between two variables without fitting a specific model. Smoothed lines are most useful when the curvature of the relationship does not change sharply.
Line style changed to smoothed line using XlsIO
To create a line chart and change the line style to a smoothed line in Excel using XlsIO, you need to do the following steps.
Steps to create and change the line style to a smoothed line
- Initialize chart
Create a chart object by calling the worksheet.Charts.Add method and specify the chart type to ExcelChartType.Line enumeration value.
// Create the chart IChartShape chart = worksheet.Charts.Add(); // Set chart type to Line chart.ChartType = ExcelChartType.Line;
- Assign data
Set a range of data from the worksheet to the chart’s DataRange property. To plot the series values in a column and categories in a row, set the chart’s IsSeriesInRows property to false.
// Set region of Chart data chart.DataRange = worksheet["A1:D6"]; // Set chart series in column for assigned data region chart.IsSeriesInRows = false;
- Apply basic chart elements
Add the basic elements like the chart title, legend and data labels.
- ChartTitle of the chart object.
- Set DataLabels via DefaultDataPoint.
- Set TRUE to the chart’s HasLegend property, to show the legend.
// Set chart title chart.ChartTitle = "Line Chart"; // Set datalabels IChartSerie serie1 = chart.Series[0];
serie1.DataPoints.DefaultDataPoint.DataLabels.IsValue = true; serie1.SerieFormat.CommonSerieOptions.IsVaryColor = true; // Set legend chart.HasLegend = true; chart.Legend.Position = ExcelLegendPosition.Bottom;
- Change line style to a smoothed line
Change the line style of chart series to a smoothed line.
- Change the line style by using the IsSmoothedLine property.
// Change line style (serie2.SerieFormat as ChartSerieDataFormatImpl).IsSmoothedLine = true;
Applicable properties for a Line Chart
Common property applicable for a line charts is
- IsVarycolor (This property holds good for single series chart).
Applying other properties apart from the mentioned property might throw exception or the changes will not be reflected in the output document because those properties are not related to line chart.
To know more about creating charts with various settings using XlsIO, please refer the documentation.
The following C#/ VB.NET complete code snippet shows how to change line style to smoothed line in line chart using XlsIO.
C#
using Syncfusion.XlsIO; using System.Reflection; using System.IO; using Syncfusion.XlsIO.Implementation.Charts; namespace Line_Style { class Program { static void Main(string[] args) { using (ExcelEngine excelEngine = new ExcelEngine()) { IApplication application = excelEngine.Excel; application.DefaultVersion = ExcelVersion.Excel2016; // Open existing workbook with data entered Assembly assembly = typeof(Program).GetTypeInfo().Assembly; Stream fileStream = assembly.GetManifestResourceStream("Line_Style.InputTemplate.xlsx"); IWorkbook workbook = application.Workbooks.Open(fileStream); IWorksheet worksheet = workbook.Worksheets[0]; // Initialize chart IChartShape chart = worksheet.Charts.Add(); chart.ChartType = ExcelChartType.Line; // Assign data chart.DataRange = worksheet["A1:D6"]; chart.IsSeriesInRows = false; // Apply chart elements // Set chart title chart.ChartTitle = "Line Chart"; // Set legend chart.HasLegend = true; chart.Legend.Position = ExcelLegendPosition.Bottom; // Set dataLabels IChartSerie serie1 = chart.Series[0]; IChartSerie serie2 = chart.Series[1]; IChartSerie serie3 = chart.Series[2]; serie1.DataPoints.DefaultDataPoint.DataLabels.IsValue = true; serie2.DataPoints.DefaultDataPoint.DataLabels.IsValue = true; serie3.DataPoints.DefaultDataPoint.DataLabels.IsValue = true; serie1.SerieFormat.CommonSerieOptions.IsVaryColor = true; serie2.SerieFormat.CommonSerieOptions.IsVaryColor = true; serie3.SerieFormat.CommonSerieOptions.IsVaryColor = true; // Change line style (serie2.SerieFormat as ChartSerieDataFormatImpl).IsSmoothedLine = true; // Positioning the chart in the worksheet chart.TopRow = 8; chart.LeftColumn = 1; chart.BottomRow = 23; chart.RightColumn = 8; // Saving the workbook Stream stream = File.Create("Output.xlsx"); workbook.SaveAs(stream); } } } }
VB
Imports Syncfusion.XlsIO Imports System.Reflection Imports System.IO Imports Syncfusion.XlsIO.Implementation.Charts Namespace Line_Style Class Program Private Shared Sub Main(ByVal args() As String) Dim excelEngine As ExcelEngine = New ExcelEngine Dim application As IApplication = excelEngine.Excel application.DefaultVersion = ExcelVersion.Excel2016 'Open existing workbook with data entered Dim assembly As Assembly = GetType(Program).GetTypeInfo.Assembly Dim fileStream As Stream = assembly.GetManifestResourceStream("Line_Style.InputTemplate.xlsx") Dim workbook As IWorkbook = application.Workbooks.Open(fileStream) Dim worksheet As IWorksheet = workbook.Worksheets(0) 'Initialize chart Dim chart As IChartShape = worksheet.Charts.Add chart.ChartType = ExcelChartType.Line 'Assign data chart.DataRange = worksheet("A1:D6") chart.IsSeriesInRows = False 'Apply chart elements 'Set chart title chart.ChartTitle = "Line Chart" 'Set legend chart.HasLegend = True chart.Legend.Position = ExcelLegendPosition.Bottom 'Set dataLabels Dim serie1 As IChartSerie = chart.Series(0) Dim serie2 As IChartSerie = chart.Series(1) Dim serie3 As IChartSerie = chart.Series(2) serie1.DataPoints.DefaultDataPoint.DataLabels.IsValue = True serie2.DataPoints.DefaultDataPoint.DataLabels.IsValue = True serie3.DataPoints.DefaultDataPoint.DataLabels.IsValue = True serie1.SerieFormat.CommonSerieOptions.IsVaryColor = True serie2.SerieFormat.CommonSerieOptions.IsVaryColor = True serie3.SerieFormat.CommonSerieOptions.IsVaryColor = True 'Change line style CType(serie2.SerieFormat, ChartSerieDataFormatImpl).IsSmoothedLine = True 'Positioning the chart in the worksheet chart.TopRow = 8 chart.LeftColumn = 1 chart.BottomRow = 23 chart.RightColumn = 8 'Saving the workbook Dim stream As Stream = File.Create("Output.xlsx") workbook.SaveAs(stream) End Sub End Class End Namespace
Take a moment to peruse the documentation where you can find basic Excel document processing options along with the features like import and export data, chart, formulas, conditional formatting, data validation, tables, pivot tables and protect the Excel documents, and most importantly, the PDF, CSV and Image conversions with code examples.
Conclusion
I hope you enjoyed learning about how to change line style in line chart using WinForms XlsIO.
You can refer to our WinForms Excel feature tour page to know about its other groundbreaking feature representations and documentation, and how to quickly get started for configuration specifications. You can also explore our WinForms Excel example to understand how to create and manipulate data.
For current customers, you can check out our components from the License and Downloads page. If you are new to Syncfusion, you can try our 30-day free trial to check out our other controls.
If you have any queries or require clarifications, please let us know in the comments section below. You can also contact us through our support forums, Direct-Trac, or feedback portal. We are always happy to assist you!