Bunifu Line Chart
Add perfect Line and Area chart representations for your data with Bunifu Line Chart.
Overview
Bunifu Line Chart is a chart component that renders a dataset as a single line path on the canvas. It can also be set to render area charts suitable for displaying quantitative data, often for comparing two sets of data.
Here is an example of a sales dashboard using Bunifu Line Chart.
Getting started
Getting started with Design View
This section explains to you the steps required to start creating a simple line chart in the design view.
Step 1: Drag the canvas control to the form from the toolbox
Step 2: In the property window of the canvas on the labels property, add the following values in the string collection editor window as shown below:
Step 3: From the toolbox drag and drop BunifuLineChart to the form.
Step 4: Click the ellipsis button on the Data property of BunifuLine, and add the following values to the collection window editor displayed as shown below:
Step 5: Go to the property named TargetCanvas select bunifuChartCanvas1 as the target component.
Step 6: Advance to BunifuLineChart properties and set a name on the Label property. An example would be No. of Solid State Drives repaired.
Step 7: Run the application.
Advance to BunifuLineChart properties and set a name on the Label property. An example would be No. of Solid State Drives repaired.
Alternatively, we can code and render a line chart without using the design view. Here's how to do it:
Code View
void renderLineChart()
{
Bunifu.Charts.WinForms.ChartTypes.BunifuLineChart bunifuLineChart = new Bunifu.Charts.WinForms.ChartTypes.BunifuLineChart();
/*
* For this example we will use random numbers
*/
var r = new Random();
/*
* Add your data from your source - accepts double list
* Below is an example from a random number
*/
List<double> data = new List<double>();
data.Add(-30);
for (int i = 0; i < 5; i++)
{
data.Add(r.NextDouble());
}
/*
* Set your data
*/
bunifuLineChart.Data = data;
/*
* Specify the target canvas
*/
bunifuLineChart.TargetCanvas = bunifuChartCanvas1;
/*
* Add labels to your canvas
* Label count should correspond to data count for charts like Bar charts
*/
bunifuChartCanvas1.Labels = new string[] { "Label1", "Label2", "Label3", "Label4", "Label5" };
/*
* Beautify the chart by sepcifying the colors
*/
bunifuLineChart.BackgroundColor = Color.Purple;
}
Let us examine Bunifu Line charting properties.
Line properties
1. CubicInterpolationMode
This property gets and sets the algorithm that draws the curves of a spline line chart. The default algorithm uses a custom weighted cubic interpolation, which renders smooth curves, and the monotone algorithm preserves monotonicity (i.e. it reserves a strict order of the dataset being interpolated/plotted) suitable for presenting y=f(x) datasets.
the code below illustrates how to set the cubic interpolation at run-time.
private void bunifuRadioButton1_CheckedChanged2(object sender, Bunifu.UI.WinForms.BunifuRadioButton.CheckedChangedEventArgs e)
{
if (e.Checked)
{
//sets the default cubic interploation mode
bunifuLineChart1.CubicInterpolationMode = BunifuLineChart.CubicInterpolationModes.Default;
}
else
{
//sets a monotone cubic interpolation mode
bunifuLineChart1.CubicInterpolationMode = BunifuLineChart.CubicInterpolationModes.Monotone;
}
}2. LineTension
Gets and sets a double numeric value that changes a curve tension of a spline line chart. A zero value renders straight line charts.
Note that the property doesn’t work when
a monotone algorithm is used in the cubic interpolation mode property.
rendering a stepped line chart.
3. Order
This property gets and sets the z-order index of a dataset in the case of multiple datasets. A dataset having a less order number will be displayed in front of other line datasets.
As can see, the code below assigns different higher negative order values to render the line plots above the other line plots.
private void setBorderWidth(BunifuLineChart bunifuLineChart, int width)
{
bunifuLineChart.BorderWidth = width;
}
private void bunifuRadioButton1_CheckedChanged2(object sender, Bunifu.UI.WinForms.BunifuRadioButton.CheckedChangedEventArgs e)
{
if (e.Checked){
bunifuLineChart1.Order = 0;
bunifuLineChart2.Order = 1;
bunifuLineChart3.Order = 2;
setBorderWidth(bunifuLineChart1, 6);
setBorderWidth(bunifuLineChart2, 3);
setBorderWidth(bunifuLineChart3, 3);
}
}
private void bunifuRadioButton2_CheckedChanged2(object sender, Bunifu.UI.WinForms.BunifuRadioButton.CheckedChangedEventArgs e)
{
if (e.Checked)
{
bunifuLineChart2.Order = -1;
bunifuLineChart1.Order = 0;
bunifuLineChart3.Order = 2;
setBorderWidth(bunifuLineChart2, 6);
setBorderWidth(bunifuLineChart1, 3);
setBorderWidth(bunifuLineChart3, 3);
}
}
private void bunifuRadioButton3_CheckedChanged2(object sender, Bunifu.UI.WinForms.BunifuRadioButton.CheckedChangedEventArgs e)
{
if (e.Checked)
{
bunifuLineChart3.Order = -2;
bunifuLineChart1.Order = 0;
bunifuLineChart2.Order = 2;
setBorderWidth(bunifuLineChart3, 6);
setBorderWidth(bunifuLineChart2, 3);
setBorderWidth(bunifuLineChart1, 3);
}
}4.ShowLine
This property gets and sets a boolean value (true or false) to hide or show the line on the canvas. A false value will hide the line plot but display the data points.
5. SteppedLine
This property gets and sets the type of line to render on the canvas. Values of a stepped line include;
False: does not render a step plot. It is the common default value, for rendering a spline chart
Before: renders a plot value before the next step of a data category. The same graphical plot is also applied with the true value. Below is its illustration
Middle: renders a plot value in the middle step of a data category
After: which renders a plot value after the next step of data category.
Border (Line plot) properties
1. BorderCapStyle
This property gets or sets the end cap style of a line plot. The property can be set to one of the following the values can be configured as follows:
Butt - renders a squared border style for the line plot's beginning and end. This is the line plot's default value.
Square - functions similarly as a Butt prop value where it renders a squared border cap at the end and at the start of the line plot.
Round - renders a rounded cap at the start and at the end of the line plot.
The following code demonstrates how to change the border cap at run-time.
using Bunifu.Charts.WinForms.ChartTypes;
private void bunifuRadioButton1_CheckedChanged(object sender, Bunifu.UI.WinForms.BunifuRadioButton.CheckedChangedEventArgs e)
{
if (e.Checked)
{
bunifuLineChart1.BorderCapStyle = BunifuLineChart.LineCaps.Butt;
bunifuChartCanvas1.Update();
}
}
private void bunifuRadioButton2_CheckedChanged(object sender, Bunifu.UI.WinForms.BunifuRadioButton.CheckedChangedEventArgs e)
{
if (e.Checked)
{
bunifuLineChart1.BorderCapStyle = BunifuLineChart.LineCaps.Round;
bunifuChartCanvas1.Update();
}
}2. BorderWidth
This property gets and sets an integer value that changes the line plot's width. The greater the value, the denser the line plot.
Data Point properties
1. PointBackgroundColor
This property sets or gets a data point background color on the line plot.
2. PointBorderColor
This property gets and sets a color value to the point border on a line plot.
3. PointBorderWidth
This property gets and sets an integer number that changes the border width of the line's data points.
4. PointRadius
This property gets or sets the integer value that decreases or increases the radius of a point (i.e. distance from the point’s center to its border). It can as well be used to enlarge the points on a line plot.
5. PointStyle
This property gets or sets a shape (circle, star, line, etc...) to render as a data point on the line plot.
6. PointRotation
This property gets or sets the integer value that changes the angle of points on a line plot.
The code below shows how to set the PointStyle and PointRotation properties at run-time.
using Bunifu.Charts.WinForms.ChartTypes;
using System;
//using a dropdown SelectedIndex property to change the style of a point
private void bunifuDropdown1_SelectedIndexChanged(object sender, EventArgs e)
{
if (bunifuDropdown1.SelectedIndex == 0)
{
bunifuLineChart1.PointStyle = BunifuLineChart.PointStyles.Circle;
}
else if (bunifuDropdown1.SelectedIndex == 1)
{
bunifuLineChart1.PointStyle = BunifuLineChart.PointStyles.CrossRot;
}
else if (bunifuDropdown1.SelectedIndex == 2)
{
bunifuLineChart1.PointStyle = BunifuLineChart.PointStyles.RectRounded;
}
else
{
bunifuLineChart1.PointStyle = BunifuLineChart.PointStyles.Triangle;
}
}
/*On an slider scroll event the PointRotation property of the
line chart shall be set with the slider's value;*/
private void bunifuHSlider1_Scroll(object sender, Utilities.BunifuSlider.BunifuHScrollBar.ScrollEventArgs e)
{
bunifuLineChart1.PointRotation = bunifuHSlider2.Value;
bunifuChartCanvas1.Update();
}7. PointHoverBackgroundColor
This property sets a color value property to the point's background when a mouse pointer hovers over a data point from the line plot.
8. PointHoverBorderWidth
This property sets an integer value property to the point's border width on a mouse hover. When a mouse pointer hovers over a data point in a line plot, this property sets an integer value property to the point's border width.
9. PointHoverRadius
This property sets the integer value that decreases or increases the radius of a point (i.e. distance from the point’s center to its border), when a mouse pointer hovers over a data point from the line plot. It can as well be used to enlarge the hovered point on a line plot.
Creating Area Charts
Bunifu line can also be used to create spline-area charts or stepped-line area charts by utilizing the following properties:
1.BackgroundColor property
This property gets and sets the color value for the background fill. It can accept an RGB color specification or an ARGB color specification. In addition, the property is also used to set the colors of the line data points.
2. Fill property
This property gets and sets the type of fill mode for its background color. A false value will disable the fill mode. The following are the possible values to use in the property:
Start: Fills the background color on the bounded line plot area.
Origin: Fills the background color on the space within the bounding line. It has the same effect as setting the Fill property to the start value.
End: Fills the background color on the outer area of the bounding line plot.
Blank: This is the default value of rendering a line chart. It renders a line plot without a background color around the boundary line.
Here's a sample application using the FillType prop values at run-time as explained from above
Setting the FillType property at runtime is demonstrated in the following code:
using Bunifu.Charts.WinForms.ChartTypes;
using System;
//the radio buttons are used to change the different values used in the FillType property.
private void bunifuRadioButton1_CheckedChanged2(object sender, Bunifu.UI.WinForms.BunifuRadioButton.CheckedChangedEventArgs e)
{
if (e.Checked)
{
bunifuLineChart1.Fill = BunifuLineChart.FillOptions.Blank;
}
}
private void bunifuRadioButton2_CheckedChanged2(object sender, Bunifu.UI.WinForms.BunifuRadioButton.CheckedChangedEventArgs e)
{
if (e.Checked)
{
bunifuLineChart1.Fill = BunifuLineChart.FillOptions.Start;
}
}
private void bunifuRadioButton3_CheckedChanged2(object sender, Bunifu.UI.WinForms.BunifuRadioButton.CheckedChangedEventArgs e)
{
if (e.Checked)
{
bunifuLineChart1.Fill = BunifuLineChart.FillOptions.End;
}
}There are 3 types of area charts that Bunifu Line can render: single area charts (as shown in the above picture) , overlapping area charts, and stacked area charts.
A single area chart contains one dataset category whereas overlapping and stacked area charts have at most 2 dataset categories.
Avoid using area charts when there are more than 3-4 categories. In that case use line charts.
To create an overlapping chart have a pair of bunifu lines each having different datasets. Each to have a FillType value of start and set its background colors.
To render a stacked area chart, set the canvas's XAxesStacked property to true. The outcome is depicted below.
Take Away
Bunifu Line Chart is an excellent charting tool in condensing both small and large datasets into manageable visualizations - and it's more enjoyable than poring over tables. If you've ever designed a dashboard or worked on another project that requires data visualization, you understand how difficult it can be to design such dashboards. Bunifu Line chart is able to assist you in creating visually appealing dashboards.
Last updated
Was this helpful?