Bunifu Horizontal bar Chart

Overview
Bunifu Horizontal Chart is a chart component that presents datasets on proportional horizontal bars. Here, the data categories are placed on the graph's vertical axis, while the numerical values are placed on the horizontal axis of the graph.
This chart tool enables you to display lengthy discrete data from a category while still leaving room for textual information, allowing the report viewer to immediately see comparative relationships and approximate numeric values. The example below highlights the real value of a bar chart in telling the "story" of the data.
Getting Started
Getting started with design view
This section explains the steps required to start creating a simple horizontal bar chart and demonstrate the basic property usage of the chart.
Step 1: Drag the canvas control to the form from the toolbox and set padding to it.
Step 2: In the property window of the canvas, access the labels property, and add the following values in the string collection editor window as shown below:
Step 3: From the toolbox drag and dropBunifuHorizontalBar to the form.
Step 4: Set the label property of BunifuHorizontalBar to, for example, (Net income profits for Q1 2021 (in billion U.S dollars)
Step 5: On the target property of the Horizontal bar component select bunifuCanvas1 as the target component.
Step 6: Access the Data property of BunifuHorizontalBar, and add the following values to the collection editor displayed as shown below:
Step 7: Go to the colors/BackgroundColor property of the Horizontal Bar and set the following color in the color collection editor:7, 162, 135
Step 8: Run the application
Alternatively, we can code and render a bar chart without using the design view. Here's how to do it:
Code View
C#
VB
1
 void renderHorizontalChart()
2
        {
3
            Bunifu.Charts.WinForms.ChartTypes.BunifuHorizontalBarChart bunifuHChart = new Bunifu.Charts.WinForms.ChartTypes.BunifuHorizontalBarChart();
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.NextDouble());
18
            }
19
            /*
20
             * Set your data             
21
             */
22
            bunifuHChart.Data = data;
23
​
24
            /*
25
             * Specify the target canvas
26
             */
27
            bunifuHChart.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
            bgColors.Add(Color.Red);
41
            bgColors.Add(Color.Blue);
42
            bgColors.Add(Color.Green);
43
            bgColors.Add(Color.Gray);
44
            bgColors.Add(Color.Purple);
45
​
46
            bunifuHChart.BackgroundColor = bgColors;
47
        }
48
​
Copied!
1
Private Sub renderHorizontalChart()
2
    Dim bunifuHChart As Bunifu.Charts.WinForms.ChartTypes.BunifuHorizontalBarChart = New Bunifu.Charts.WinForms.ChartTypes.BunifuHorizontalBarChart()
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.NextDouble())
16
    Next
17
​
18
    ' 
19
    '  Set your data             
20
    ' 
21
    bunifuHChart.Data = data
22
​
23
    ' 
24
    '  Specify the target canvas
25
    ' 
26
    bunifuHChart.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
    bgColors.Add(Color.Red)
40
    bgColors.Add(Color.Blue)
41
    bgColors.Add(Color.Green)
42
    bgColors.Add(Color.Gray)
43
    bgColors.Add(Color.Purple)
44
    bunifuHChart.BackgroundColor = bgColors
45
End Sub
46
​
Copied!
Let us examine Bunifu Horizontal Bar charting properties.
Creating Your Data
1. Target Canvas
This property gets or sets the canvas on which the horizontal bar chart will be displayed. Multiple horizontal bar charts with distinct datasets can be targeted on a single canvas, creating grouped or horizontally stacked charts.
2. Data (numerical data)
This property gets or sets a collection of both negative and positive values that the canvas will be present on the X-Axis proportionally for the horizontal bar value. The order in which data values are added to the property corresponds to how the canvas label values are put.  
Setting and assigning data to the horizontal bar chart can be done by either using the Data property found on the property pane of the design mode or using code. The example below illustrates using both C# and VB.NET codes to populate the horizontal bar chart with a sorted data at run-time:
C#
VB.NET
1
    public class FoodRevenueData
2
        {
3
            public double USData { get; set; }
4
            public double GermanData { get; set; }
5
            public double KenyanData { get; set; }
6
            public double FranceData { get; set; }
7
            public double UKData { get; set; }
8
            public double ChinaData { get; set; }
9
            public double ItalyData { get; set; }
10
            public double SwitzerLandData { get; set; }
11
        }
12
        private void RevenueForm_Load(object sender, EventArgs e)
13
        {
14
            //Set data to the class properties
15
            FoodRevenueData data = new FoodRevenueData()
16
            {
17
                USData = 44727,
18
                GermanData = 11970,
19
                FranceData = 11295,
20
                ChinaData = 18205,
21
                ItalyData = 13265,
22
                SwitzerLandData = 21133,
23
                KenyanData = 23014,
24
                UKData = 42299
25
            };
26
            //map the property values of the class with its key(the country!)
27
            Dictionary<String, Double> revenueByCountry = new Dictionary<string, double>();
28
            revenueByCountry.Add("United States of America", data.USData);
29
            revenueByCountry.Add("German", data.GermanData);
30
            revenueByCountry.Add("France", data.FranceData);
31
            revenueByCountry.Add("China", data.ChinaData);
32
            revenueByCountry.Add("Italy", data.ItalyData);
33
            revenueByCountry.Add("SwitzerLand", data.SwitzerLandData);
34
            revenueByCountry.Add("Kenya", data.KenyanData);
35
            revenueByCountry.Add("United Kingdom", data.UKData);
36
            /*
37
            * sort data in the dictionary by value in a descending order and
38
              assign the data to the list
39
            */
40
            List<string> y_AxisLabels = new List<string>();
41
            List<double> horizontalBarData = new List<double>();
42
           
43
            foreach (var countryData in revenueByCountry.OrderByDescending(x=>x.Value))
44
            {
45
                y_AxisLabels.Add(countryData.Key);
46
                horizontalBarData.Add(countryData.Value);
47
            }
48
​
49
            //assign the values
50
            bunifuChartCanvas1.Labels = y_AxisLabels.ToArray();
51
            bunifuHorizontalBarChart1.Data = horizontalBarData;
52
        }
53
    
Copied!
1
Option Infer On
2
​
3
Public Class FoodRevenueData
4
			Public Property USData() As Double
5
			Public Property GermanData() As Double
6
			Public Property KenyanData() As Double
7
			Public Property FranceData() As Double
8
			Public Property UKData() As Double
9
			Public Property ChinaData() As Double
10
			Public Property ItalyData() As Double
11
			Public Property SwitzerLandData() As Double
12
End Class
13
		Private Sub RevenueForm_Load(ByVal sender As Object, ByVal e As EventArgs)
14
			'Set data to the class properties
15
			Dim data As New FoodRevenueData() With {
16
				.USData = 44727,
17
				.GermanData = 11970,
18
				.FranceData = 11295,
19
				.ChinaData = 18205,
20
				.ItalyData = 13265,
21
				.SwitzerLandData = 21133,
22
				.KenyanData = 23014,
23
				.UKData = 42299
24
			}
25
			'map the property values of the class with its key(the country!)
26
			Dim revenueByCountry As New Dictionary(Of String, Double)()
27
			revenueByCountry.Add("United States of America", data.USData)
28
			revenueByCountry.Add("German", data.GermanData)
29
			revenueByCountry.Add("France", data.FranceData)
30
			revenueByCountry.Add("China", data.ChinaData)
31
			revenueByCountry.Add("Italy", data.ItalyData)
32
			revenueByCountry.Add("SwitzerLand", data.SwitzerLandData)
33
			revenueByCountry.Add("Kenya", data.KenyanData)
34
			revenueByCountry.Add("United Kingdom", data.UKData)
35
'            
36
'            * sort data in the dictionary by value in a descending order and
37
'              assign the data to the list
38
'            
39
			Dim y_AxisLabels As New List(Of String)()
40
			Dim horizontalBarData As New List(Of Double)()
41
​
42
			For Each countryData In revenueByCountry.OrderByDescending(Function(x) x.Value)
43
				y_AxisLabels.Add(countryData.Key)
44
				horizontalBarData.Add(countryData.Value)
45
			Next countryData
46
​
47
			'assign the values
48
			bunifuChartCanvas1.Labels = y_AxisLabels.ToArray()
49
			bunifuHorizontalBarChart1.Data = horizontalBarData
50
		End Sub
51
​
Copied!
Here's is the output of the code:
3. Label (Legend 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.
Styling the Bars Appearance
1. BackgroundColor
This property gets or sets the bar's background color value. We can specify the colors using the Red Green Blue (RGB) color format as well as the Alpha, Red, Green, and Blue (ARGB) color values in the color collection editor. By specifying a single color value in the property, the background color of all the bars in the canvas will be set to that value.
The figure below is an illustration where we have specified the ARGB color value 160, 7, 162, 135 in the color collection editor to render the bar's background color with a transparency view:
Each bar can be customized by adding additional color sets to the color selection editor. However, let us add the background colors using code that will be executed on run-time. The following code demonstrates the BackgroundColor property set with a list of colors, that will apply a distinct background color to each horizontal bar during a form load event:
C#
VB.NET
1
      private void Form1_Load(object sender, EventArgs e)
2
        {
3
            List<Color> colorsList = new List<Color>();
4
            colorsList.AddRange(new Color[]{
5
            Color.FromArgb(7, 162, 135),
6
            Color.FromArgb(204, 255, 102),
7
            Color.FromArgb(82, 72, 156),
8
            Color.FromArgb(64, 98, 187),
9
            Color.FromArgb(83, 62, 45)
10
            });
11
​
12
            bunifuHorizontalBarChart1.BackgroundColor = colorsList;
13
        }
Copied!
1
	  Private Sub Form1_Load(ByVal sender As Object, ByVal e As EventArgs)
2
			Dim colorsList As New List(Of Color)()
3
			 colorsList.AddRange(New Color(){
4
			 Color.FromArgb(7, 162, 135),
5
			 Color.FromArgb(204, 255, 102), 
6
			 Color.FromArgb(82, 72, 156),
7
			 Color.FromArgb(64, 98, 187), 
8
			 Color.FromArgb(83, 62, 45)
9
			 })
10
​
11
			bunifuHorizontalBarChart1.BackgroundColor = colorsList
12
	  End Sub
13
​
Copied!
Here's the output of a multi-colored horizontal bar chart from the code above:
When using a multi-colored horizontal bar chart it is advisable to hide the chart's legend and ensure the X-axis is labelled to convey the values meaning.
 To hide the legend access the canvas'sLegendDisplay property and set it to False. Whereas to label the X-axis, go to the XAxesLabel property and set to, for example, "Share of playing time (in %)".
2. 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. Below is a sample illustration of the border color applied to the bar. We have specified again an RGB color of 240, 246, 110. 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.
Additionally, we can specify different border colors for each bar by providing an array of colors in the color collection editor, but let's do so using the code method, where we shall assign the bordercolor prop with a list variable of type color:
C#
VB.NET
1
        private void Form1_Load(object sender, EventArgs e)
2
        {
3
            List<Color> colorList = new List<Color>();
4
            colorList.AddRange(new Color[]
5
            {
6
                Color.FromArgb(240, 246, 110),
7
                Color.FromArgb(45, 45, 42),
8
                Color.FromArgb(50, 13, 109),
9
                Color.FromArgb(67, 100, 54),
10
                Color.FromArgb(90, 210, 244),
11
                Color.FromArgb(159, 164, 169)
12
            });
13
            bunifuHorizontalBarChart1.BorderColor = colorList;
14
        }
Copied!
1
 Private Sub Form1_Load(ByVal sender As Object, ByVal e As EventArgs)
2
			Dim colorList As New List(Of Color)()
3
			colorList.AddRange(New Color() { Color.FromArgb(240, 246, 110), Color.FromArgb(45, 45, 42), Color.FromArgb(50, 13, 109), Color.FromArgb(67, 100, 54), Color.FromArgb(90, 210, 244), Color.FromArgb(159, 164, 169) })
4
			bunifuHorizontalBarChart1.BorderColor = colorList
5
 End Sub
6
​
Copied!
Here's the output of the code above which sets colored borders for each horizontal bar.
3. BorderSkipped
This property gets or sets a side value that conceals the border-stroke of the bar on the specified side. It has the following side values:
a) Top - hides the top border-stroke of each horizontal bar rendered.
b) Bottom - hides the bottom border-stroke of each horizontal bar rendered
c) Left - hides the left border-stroke of each horizontal bar rendered
d) Right  - hides the right border-stroke of each horizontal bar rendered.
e) False - shows border-strokes on all the four sides of each horizontal bar rendered.
The following conditions must be met for the property to function properly:
a) Ensure that the BorderWidth prop is not set to 0.
b) Ensure that theBorderColor prop is set to a visible color.
The following code shows how to set the values of the BorderSkipped property at run-time by using Bunifu Radio Button 
C#
VB.NET
1
  private void topBunifuRadioButton_CheckedChanged2(object sender, Bunifu.UI.WinForms.BunifuRadioButton.CheckedChangedEventArgs e)
2
        {
3
            if (e.Checked)
4
            {
5
                bunifuHorizontalBarChart1.BorderSkipped = "top"; 
6
            }
7
        }
8
​
9
    private void bottomBunifuRadioButton_CheckedChanged2(object sender, Bunifu.UI.WinForms.BunifuRadioButton.CheckedChangedEventArgs e)
10
        {
11
            if (e.Checked)
12
            {
13
                bunifuHorizontalBarChart1.BorderSkipped = "bottom";
14
        }
15
    }
16
​
17
    private void leftBunifuRadioButton_CheckedChanged2(object sender, Bunifu.UI.WinForms.BunifuRadioButton.CheckedChangedEventArgs e)
18
        {
19
            if (e.Checked)
20
            {
21
                bunifuHorizontalBarChart1.BorderSkipped = "left";
22
            }
23
        }
24
​
25
    private void rightBunifuRadioButton_CheckedChanged2(object sender, Bunifu.UI.WinForms.BunifuRadioButton.CheckedChangedEventArgs e)
26
        {
27
            if (e.Checked)
28
            {
29
                bunifuHorizontalBarChart1.BorderSkipped = "right";
30
            }
31
        }
32
​
33
    private void falseBunifuRadioButton_CheckedChanged2(object sender, Bunifu.UI.WinForms.BunifuRadioButton.CheckedChangedEventArgs e)
34
        {
35
            if (e.Checked)
36
            {
37
                bunifuHorizontalBarChart1.BorderSkipped = "false";
38
            }
39
        }
Copied!
1
  Private Sub topBunifuRadioButton_CheckedChanged2(ByVal sender As Object, ByVal e As Bunifu.UI.WinForms.BunifuRadioButton.CheckedChangedEventArgs)
2
			If e.Checked Then
3
				bunifuHorizontalBarChart1.BorderSkipped = "top"
4
			End If
5
  End Sub
6
​
7
		Private Sub bottomBunifuRadioButton_CheckedChanged2(ByVal sender As Object, ByVal e As Bunifu.UI.WinForms.BunifuRadioButton.CheckedChangedEventArgs)
8
			If e.Checked Then
9
				bunifuHorizontalBarChart1.BorderSkipped = "bottom"
10
			End If
11
		End Sub
12
​
13
		Private Sub leftBunifuRadioButton_CheckedChanged2(ByVal sender As Object, ByVal e As Bunifu.UI.WinForms.BunifuRadioButton.CheckedChangedEventArgs)
14
			If e.Checked Then
15
				bunifuHorizontalBarChart1.BorderSkipped = "left"
16
			End If
17
		End Sub
18
​
19
		Private Sub rightBunifuRadioButton_CheckedChanged2(ByVal sender As Object, ByVal e As Bunifu.UI.WinForms.BunifuRadioButton.CheckedChangedEventArgs)
20
			If e.Checked Then
21
				bunifuHorizontalBarChart1.BorderSkipped = "right"
22
			End If
23
		End Sub
24
​
25
		Private Sub falseBunifuRadioButton_CheckedChanged2(ByVal sender As Object, ByVal e As Bunifu.UI.WinForms.BunifuRadioButton.CheckedChangedEventArgs)
26
			If e.Checked Then
27
				bunifuHorizontalBarChart1.BorderSkipped = "false"
28
			End If
29
		End Sub
30
​
Copied!
4. BorderWidth
This property gets and sets an integer value that can modify the width of the bar’s border.
Hover Event properties
1. HoverBackgroundColor
This property sets a back color value to a horizontal bar on which the mouse pointer is suspended.
2. HoverBorderColor
This property changes the color of the border around a horizontal bar that the mouse pointer is hovering over.
3. HoverBorderWidth
This property sets an integer value that changes the width of the boundary of a horizontal bar over which the mouse pointer is hovering.
Creating Horizontal Stacked Bar Charts
Bunifu Horizontal bar can also be set to render groups of segmented bars. Typically, each horizontal bar in the graph represents a data category that is further subdivided into stacked subcategories of datasets. It helps to know which subcategory contributes the most or the least to a data variable.
To stack groups of horizontal bars, simply set the X-AxisStacked property of the canvas to true. 
The X-AxisStacked property is effective in rendering stacked bars when a canvas has multiple groups of horizontal bars within a category.
The following example shows three horizontal bars each containing different datasets, stacked on top of one another.
Take Away
Bunifu Horizontal Chart is a great chart tool. With minimal code generation, you can render a stunning horizontal bar chart for your data analysis applications. It is straightforward to read data; We can quickly determine which of the elements ahead of us is longer, which is the shortest.
What you should do is consider what you are trying to say about the values. Data Visualization is more than pointing out information: you’re usually presenting this information to your application users to get them to do something or learn something new.
​