Bunifu Bar Chart

Overview
BunifuBarChart is a chart component that displays data values represented as vertical bars (also called columns) on a canvas layout. It is fine-tuned to render multiple data series that can be arranged in a stacked or side-by-side arrangement. 
It also provides developers the ability to plot negative values that render vertical bars which descend below the x-axis plane. It is used to show data trends and comparisons of multiple data sets. Here’s a visual example of an application that uses the BunifuBarChartcomponent to render data.
Getting Started
This section explains to you the steps required to start creating a simple bar chart and demonstrate the basic usage of the  BunifuBarChart component.
Step 1: Drag the canvas control to the form from the toolbox and place it in a good position on the form.
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 the BunifuBarChart component to the form.
Step 4: Go to the property named TargetCanvas  and select bunifuChartCanvas1 as the target component.
Step 5: Now, on the bunifuBarChart1 component properties, click the ellipsis button on the Data property, and add the following values to the collection window editor displayed as shown below:
Step 5: Run the application
Here's the result when running the application
Alternatively, we can code and render a bar chart without using the design view. Here's how to do it:
Code
C#
VB
1
  void renderBarchart()
2
        {
3
            Bunifu.Charts.WinForms.ChartTypes.BunifuBarChart bunifuBarChart = new Bunifu.Charts.WinForms.ChartTypes.BunifuBarChart();
4
            /*
5
             * For this example we will use random numbers
6
             */
7
            var r = new Random();
8
​
9
            /*
10
             * Add your data from your source - accepts double list
11
             * Below is an example from a random number
12
             */
13
            List<double> data = new List<double>();
14
​
15
            for (int i = 0; i < 5; i++)
16
            {
17
                data.Add(r.Next(0,50));
18
            }
19
            /*
20
             * Set your data             
21
             */
22
            bunifuBarChart.Data = data;
23
​
24
            /*
25
             * Specify the target canvas
26
             */
27
            bunifuBarChart.TargetCanvas = bunifuChartCanvas1;
28
​
29
            /*
30
             * Add labels to your canvas
31
             * Label count should correspond to data count for charts like Bar charts
32
             */
33
            bunifuChartCanvas1.Labels = new string[] { "Label1", "Label2", "Label3", "Label4", "Label5" };
34
​
35
            /*
36
             * Beautify the chart by sepcifying the colors
37
             * Color count should correspond to data count
38
             */
39
            List<Color> bgColors = new List<Color>();
40
            for (int i = 0; i < data.Count; i++)
41
            {
42
                bgColors.Add(Color.FromArgb(r.Next(256), r.Next(256), r.Next(256)));
43
            }
44
            bunifuBarChart.BackgroundColor = bgColors;
45
        }
Copied!
1
Private Sub renderBarchart()
2
    Dim bunifuBarChart As Bunifu.Charts.WinForms.ChartTypes.BunifuBarChart = New Bunifu.Charts.WinForms.ChartTypes.BunifuBarChart()
3
    ' 
4
    '  For this example we will use random numbers
5
    ' 
6
    Dim r = New Random()
7
​
8
    ' 
9
    '  Add your data from your source - accepts double list
10
    '  Below is an example from a random number
11
    ' 
12
    Dim data As List(Of Double) = New List(Of Double)()
13
​
14
    For i As Integer = 0 To 5 - 1
15
        data.Add(r.[Next](0, 50))
16
    Next
17
​
18
    ' 
19
    '  Set your data             
20
    ' 
21
    bunifuBarChart.Data = data
22
​
23
    ' 
24
    '  Specify the target canvas
25
    ' 
26
    bunifuBarChart.TargetCanvas = bunifuChartCanvas1
27
​
28
    ' 
29
    '  Add labels to your canvas
30
    '  Label count should correspond to data count for charts like Bar charts
31
    ' 
32
    bunifuChartCanvas1.Labels = New String() {"Label1", "Label2", "Label3", "Label4", "Label5"}
33
​
34
    ' 
35
    '  Beautify the chart by sepcifying the colors
36
    '  Color count should correspond to data count
37
    ' 
38
    Dim bgColors As List(Of Color) = New List(Of Color)()
39
​
40
    For i As Integer = 0 To data.Count - 1
41
        bgColors.Add(Color.FromArgb(r.[Next](256), r.[Next](256), r.[Next](256)))
42
    Next
43
​
44
    bunifuBarChart.BackgroundColor = bgColors
45
End Sub
46
​
Copied!
Styling the Bars’ Appearance At Design Time
BackgroundColor
This is a property that gets and sets a color value/values to the bar’s background. We can specify the colors using the ARGB which stores the Alpha transparency as well as the red, green, and blue color values, or using the named color values provided by the .NET framework library. 
Here's a sample illustration where we have specified the  ARGB color value 180,30,144,255 in the color collection editor to render the bar's background color with a transparency view.
​🕵♂
 Notice how nice the transparent background color has been applied to the bars. Awesome!
We can also provide an array of different background colors for each bar by adding more color values to the color collection editor. The first color value will be applied to the first bar rendered on the canvas. Other subsequent colors provided in the color editor will be applied to the rest of the bars rendered.
For example, let's provide each bar with its own background color as shown below.
 🧲
 Copy each color value separately from the list below:
180, 30, 144, 255
180, 13, 6, 48
180, 24, 49, 79
139, 190, 178
220, 230, 249, 175
180, 168, 32, 26
​
Here's the output after inputting the following above values in the BackgroundColor property
For a multicolored background bar chart, we must ensure that the chart's legend is not visible. This is done by changing the value of LegendDisplay a property of BunifuChartCanvas from true to false.
BorderColor
This property gets and sets a color value property to the bar’s borders. We can specify the colors using the .NET Framework colors, or a custom RGB standard color format, or the ARGB color format which is much better than a regular standard RGB color.
Below is a sample illustration of the border color applied to the bar. We have specified again an ARGB color of 200, 163, 163, 163.
Here's the output
​🕵♂
 To be able to see the border we should increase the width of the border using theBorderWidth property. In the example above we have set a border width of 4.
Moreover, we can also set different colors for each bar's border by providing an array of colors in the color collection editor window.
For instance, lets apply the following colors in the BorderColor property
1
//copy the colors line by line
2
​
3
183, 183, 183
4
196, 40, 71
5
20, 92, 158
6
250, 243, 62
7
236, 64, 103
8
3, 121, 113
Copied!
Here's the interface output after setting the above border colors.
BorderSkipped
This property gets and sets the side of the bar's border to hide. We can decide to hide the left, right top, or the bottom border stroke of the bars rendered.
The following values can be used in the BorderSkipped property
1.
bottom
2.
left
3.
top
4.
right
To restore a complete bordered bar, set the BorderSkipped property by specifying its value as false.  The false value means that the borders will be displayed on all sides of the bar.
The following is an illustration of a rendered bar chart where the top border is hidden.
BorderWidth
This property gets and sets an integer value that can modify the width of the bar’s border.
Working with Data
TargetCanvas
This property gets and sets the canvas that will render BunifuBarChart. One canvas can be targetted with multiple BunifuBarCharts that have different datasets.
Data
This property gets and sets an array of numbers known as a dataset, that will be represented by BunifuBarChart
The operation of setting and assigning data to BunifuBarChart can be done by either using the Data  property found on the property pane of the design mode or by the use of code. Let's look at an example of how to assign an array of data to BunifuBarChartby the code method.
Note that: 
1.
This code will be done after doing the preliminary steps of setting and styling up the canvas and BunifuBarChart in the design view.
2.
The code below has been executed on a form load event. Other relevant events can also be used to load the data.
C#
VB.NET
1
 private void DashForm_Load(object sender, EventArgs e)
2
        {
3
            List<Double> profitDataList = new List<double>()
4
            {
5
                50.90,
6
                70,
7
                80,
8
                90,
9
                53,
10
                45,
11
                73
12
            };
13
            List<Double> expenseDataList = new List<double>()
14
            {
15
                50,
16
                75,
17
                30,
18
                50,
19
                43,
20
                95,
21
                73
22
            };
23
            bunifuBarChart1.Data = profitDataList;
24
            bunifuBarChart2.Data = expenseDataList;
25
        }
Copied!
1
 Private Sub DashForm_Load(ByVal sender As Object, ByVal e As EventArgs)
2
			Dim profitDataList As New List(Of Double)() 
3
			From {50.90, 70, 80, 90, 53, 45, 73}
4
			Dim expenseDataList As New List(Of Double)()
5
			From {50, 75, 30, 50, 43, 95, 73}
6
			bunifuBarChart1.Data = profitDataList
7
			bunifuBarChart2.Data = expenseDataList
8
 End Sub
9
​
Copied!
Run the application once you have applied the above code. The illustration below shows how the above code has been rendered on run-time.
Label
This property gets and sets the text to display on the chart’s legend. To format the label, use the Legend properties available from  the canvas' properties.
Interacting with Bunifu Bar
HoverBackgroundColor
The HoverBackgroundColor property gets and sets a color value that will be displayed on the bar’s background where the mouse has been suspended on.
The illustration below shows an example of the above statement
HoverBorderColor
The HoverBorderColor property gets or sets a color value that will be displayed  on the border of the bar. When the bar is hovered, its border will display the color that has been assigned to the HoverBorderColor property.
For this property to function well, ensure that the BorderWidth has been set with an integer value which is not less than 1.
HoverBorderWidth
This property gets and sets an integer value that can modify the width of the bar’s border, when the mouse is hovered on it.
Below is a sample illustration whereby on the event of a mouse hover on a bar, the border's width increases in size!
Take Away
BunifuBarChart is a great component to use to visualize your datasets in a simple and modern Look and Feel! The beauty of BunifuBarChart is that it automatically renders its axis in a clear format and it's highly customizable. In addition the automated spacing between the bars is uniform and consistent 👌
 . Our eyes can quickly compare lengths and judge distances,  of the datasets visualized in the bars making it both simple and a highly effective component to use for data analysis. 