Cluster Bar Example for WinForms

Nevron NOV Chart for WinForms ships with hundreds of examples with full source code, as part of the Nevron Open Vision Suite. All WinForms Chart examples are also available as a stand-alone Visual Studio solution in C# and VB.NET, which you can download from the links below.

Cluster Bar Example for WinForms Description

This example demonstrates how to create a cluster bar chart.


Cluster Bar Example

C# Cluster Bar Example Code for Nevron Chart for WinForms
Language: C#

using Nevron.Nov;
using Nevron.Nov.Chart;
using Nevron.Nov.Dom;
using Nevron.Nov.Graphics;
using Nevron.Nov.Layout;
using Nevron.Nov.UI;
using Nevron.Nov.Windows.Forms;
using System;
using System.Windows.Forms;

namespace NovWinFormsProject
{
	public partial class Form1 : Form
	{
		#region Constructors

		public Form1()
		{
			InitializeComponent();

			// Set form title
			Text = "NOV WinForms - NClusterBarExample";

			// Create the NOV example and its controls
			NWidget exampleContent = CreateExampleContent();
			NWidget exampleControls = CreateExampleControls();
			if (exampleControls != null)
			{
				exampleControls.PreferredWidth = 300;
			}

			// Place the example and its controls in a pair box
			NPairBox pairBox = new NPairBox(exampleContent, exampleControls);
			pairBox.FillMode = ENStackFillMode.First;
			pairBox.FitMode = ENStackFitMode.First;
			pairBox.Margins = new NMargins(NDesign.HorizontalSpacing, NDesign.VerticalSpacing);

			// Host the example in the form
			NNovWidgetHost host = new NNovWidgetHost(pairBox);
			host.Dock = DockStyle.Fill;
			Controls.Add(host);
		}

		#endregion

		#region Example

		public NWidget CreateExampleContent()
		{
			NChartViewWithCommandBars chartViewWithCommandBars = new NChartViewWithCommandBars();
			NChartView chartView = chartViewWithCommandBars.View;
			chartView.Surface.CreatePredefinedChart(ENPredefinedChartType.Cartesian);

			// configure title
			chartView.Surface.Titles[0].Text = "Cluster Bar Labels";

			// configure chart
			NCartesianChart chart = (NCartesianChart)chartView.Surface.Charts[0];

			// add interlace stripe
			NLinearScale linearScale = chart.Axes[ENCartesianAxis.PrimaryY].Scale as NLinearScale;
			NScaleStrip strip = new NScaleStrip(new NColorFill(ENNamedColor.Beige), null, true, 0, 0, 1, 1);
			strip.Interlaced = true;
			linearScale.Strips.Add(strip);

			// add a bar series
			m_Bar1 = new NBarSeries();
			m_Bar1.Name = "Bar1";
			m_Bar1.MultiBarMode = ENMultiBarMode.Series;
			m_Bar1.DataLabelStyle = CreateDataLabelStyle();
			m_Bar1.ValueFormatter = new NNumericValueFormatter("0.###");
			chart.Series.Add(m_Bar1);

			// add another bar series
			m_Bar2 = new NBarSeries();
			m_Bar2.Name = "Bar2";
			m_Bar2.MultiBarMode = ENMultiBarMode.Clustered;
			m_Bar2.DataLabelStyle = CreateDataLabelStyle();
			m_Bar2.ValueFormatter = new NNumericValueFormatter("0.###");
			chart.Series.Add(m_Bar2);

			FillRandomData();

			chartView.Document.StyleSheets.ApplyTheme(new NChartTheme(ENChartPalette.Bright, ENChartPaletteTarget.Series));

			return chartViewWithCommandBars;
		}
		public NWidget CreateExampleControls()
		{
			NStackPanel propertyStack = new NStackPanel();
			NUniSizeBoxGroup boxGroup = new NUniSizeBoxGroup(propertyStack);

			NNumericUpDown gapPercentNumericUpDown = new NNumericUpDown();
			propertyStack.Add(NPairBox.Create("Gap Percent: ", gapPercentNumericUpDown));

			gapPercentNumericUpDown.Value = m_Bar1.WidthGapFactor * 100.0;
			gapPercentNumericUpDown.ValueChanged += gapPercentNumericUpDown_ValueChanged;

			return boxGroup;
		}
		public string GetExampleDescription()
		{
			return @"

This example demonstrates how to create a cluster bar chart.

"; } /// /// Gets the relevant documentation links for the example /// /// public (string Name, string Url)[] GetDocumentationUrls() { return new[] { ("Bar Series", "https://www.nevron.com/docs/openvision/bar-chart-series.html"), ("Common Series Functionality", "https://www.nevron.com/docs/openvision/chart-common-series-functionality.html"), ("Ordinal Scale", "https://www.nevron.com/docs/openvision/ordinal-scale.html"), }; } #endregion #region Implementation /// /// Creates a new data label style object /// /// private NDataLabelStyle CreateDataLabelStyle() { NDataLabelStyle dataLabelStyle = new NDataLabelStyle(); dataLabelStyle.Format = ""; return dataLabelStyle; } private void FillRandomData() { Random random = new Random(); for (int i = 0; i < 5; i++) { m_Bar1.DataPoints.Add(new NBarDataPoint(random.Next(10, 100))); m_Bar2.DataPoints.Add(new NBarDataPoint(random.Next(10, 100))); } } #endregion #region Event Handlers void gapPercentNumericUpDown_ValueChanged(NValueChangeEventArgs arg) { m_Bar1.WidthGapFactor = ((NNumericUpDown)arg.TargetNode).Value / 100.0; } #endregion #region Fields NBarSeries m_Bar1; NBarSeries m_Bar2; #endregion #region Static Methods #endregion #region Constants #endregion #region Nested Types #endregion } }

Download a fully functional C# (.cs) Cluster Bar Example for WinForms Solution

VB.NET Cluster Bar Example Code for Nevron Chart for WinForms
Language: VB.NET

Imports Nevron.Nov
Imports Nevron.Nov.Chart
Imports Nevron.Nov.Dom
Imports Nevron.Nov.Graphics
Imports Nevron.Nov.Layout
Imports Nevron.Nov.UI
Imports Nevron.Nov.Windows.Forms
Imports System

Public Class Form1

#Region "Constructors"

    Public Sub New()
        ' This call is required by the designer.
        InitializeComponent()

        ' Add any initialization after the InitializeComponent() call.

        ' Set form title
        Text = "NOV WinForms - NClusterBarExample"

        ' Create the NOV example and its controls
        Dim exampleContent As NWidget = CreateExampleContent()
        Dim exampleControls As NWidget = CreateExampleControls()
        If Not exampleControls Is Nothing Then
            exampleControls.PreferredWidth = 300
        End If

        ' Place the example and its controls in a pair box
        Dim pairBox As NPairBox = New NPairBox(exampleContent, exampleControls)
        pairBox.FillMode = ENStackFillMode.First
        pairBox.FitMode = ENStackFitMode.First
        pairBox.Margins = New NMargins(NDesign.HorizontalSpacing, NDesign.VerticalSpacing)

        ' Host the example in the form
        Dim host As NNovWidgetHost(Of NWidget) = New NNovWidgetHost(Of NWidget)(pairBox)
        host.Dock = DockStyle.Fill
        Controls.Add(host)
    End Sub


#End Region

#Region "Example"

        Public Function CreateExampleContent() As NWidget
            Dim chartViewWithCommandBars As NChartViewWithCommandBars = New NChartViewWithCommandBars()
            Dim chartView = chartViewWithCommandBars.View
            chartView.Surface.CreatePredefinedChart(ENPredefinedChartType.Cartesian)

            ' configure title
            chartView.Surface.Titles(0).Text = "Cluster Bar Labels"

            ' configure chart
            Dim chart = CType(chartView.Surface.Charts(0), NCartesianChart)

            ' add interlace stripe
            Dim linearScale As NLinearScale = TryCast(chart.Axes(ENCartesianAxis.PrimaryY).Scale, NLinearScale)
            Dim strip As NScaleStrip = New NScaleStrip(New NColorFill(ENNamedColor.Beige), Nothing, True, 0, 0, 1, 1)
            strip.Interlaced = True
            linearScale.Strips.Add(strip)

            ' add a bar series
            m_Bar1 = New NBarSeries()
            m_Bar1.Name = "Bar1"
            m_Bar1.MultiBarMode = ENMultiBarMode.Series
            m_Bar1.DataLabelStyle = CreateDataLabelStyle()
            m_Bar1.ValueFormatter = New NNumericValueFormatter("0.###")
            chart.Series.Add(m_Bar1)

            ' add another bar series
            m_Bar2 = New NBarSeries()
            m_Bar2.Name = "Bar2"
            m_Bar2.MultiBarMode = ENMultiBarMode.Clustered
            m_Bar2.DataLabelStyle = CreateDataLabelStyle()
            m_Bar2.ValueFormatter = New NNumericValueFormatter("0.###")
            chart.Series.Add(m_Bar2)

            FillRandomData()

            chartView.Document.StyleSheets.ApplyTheme(New NChartTheme(ENChartPalette.Bright, ENChartPaletteTarget.Series))

            Return chartViewWithCommandBars
        End Function
        Public Function CreateExampleControls() As NWidget
            Dim propertyStack As NStackPanel = New NStackPanel()
            Dim boxGroup As NUniSizeBoxGroup = New NUniSizeBoxGroup(propertyStack)

            Dim gapPercentNumericUpDown As NNumericUpDown = New NNumericUpDown()
            propertyStack.Add(NPairBox.Create("Gap Percent: ", gapPercentNumericUpDown))

            gapPercentNumericUpDown.Value = m_Bar1.WidthGapFactor * 100.0
            gapPercentNumericUpDown.ValueChanged += AddressOf gapPercentNumericUpDown_ValueChanged

            Return boxGroup
        End Function
        Public Function GetExampleDescription() As String
            Return "

This example demonstrates how to create a cluster bar chart.

" End Function ''' ''' Gets the relevant documentation links for the example ''' ''' Public Function GetDocumentationUrls() As (String, String)() Return {("Bar Series", "https://www.nevron.com/docs/openvision/bar-chart-series.html"), ("Common Series Functionality", "https://www.nevron.com/docs/openvision/chart-common-series-functionality.html"), ("Ordinal Scale", "https://www.nevron.com/docs/openvision/ordinal-scale.html")} End Function #End Region #Region "Implementation" ''' ''' Creates a new data label style object ''' ''' Private Function CreateDataLabelStyle() As NDataLabelStyle Dim dataLabelStyle As NDataLabelStyle = New NDataLabelStyle() dataLabelStyle.Format = "" Return dataLabelStyle End Function Private Sub FillRandomData() Dim random As Random = New Random() For i = 0 To 4 m_Bar1.DataPoints.Add(New NBarDataPoint(random.Next(10, 100))) m_Bar2.DataPoints.Add(New NBarDataPoint(random.Next(10, 100))) Next End Sub #End Region #Region "Event Handlers" Private Sub gapPercentNumericUpDown_ValueChanged(arg As NValueChangeEventArgs) m_Bar1.WidthGapFactor = CType(arg.TargetNode, NNumericUpDown).Value / 100.0 End Sub #End Region #Region "Fields" Private m_Bar1 As NBarSeries Private m_Bar2 As NBarSeries #End Region #Region "Static Methods" #End Region #Region "Constants" #End Region #Region "Nested Types" #End Region End Class

Download a fully functional VB.NET (.vb) Cluster Bar Example for WinForms Solution