Custom Scale Breaks 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.

Custom Scale Breaks Example for WinForms Description

This example demonstrates how to add custom scale breaks.


Custom Scale Breaks Example

C# Custom Scale Breaks 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 - NCustomScaleBreaksExample";

			// 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 = "Custom Scale Breaks";

			// configure chart
			m_Chart = (NCartesianChart)chartView.Surface.Charts[0];
			
			// configure axes
			m_Chart.SetPredefinedCartesianAxes(ENPredefinedCartesianAxis.XYLinear);

			Random random = new Random();

			// create three random point series
			for (int i = 0; i < 3; i++)
			{
				NPointSeries point = new NPointSeries();
				point.UseXValues = true;

				point.DataLabelStyle = new NDataLabelStyle(false);
				point.Size = 5;

				// fill in some random data
				for (int j = 0; j < 30; j++)
				{
					point.DataPoints.Add(new NPointDataPoint(5 + random.Next(90), 5 + random.Next(90)));
				}

				m_Chart.Series.Add(point);
			}

			// create scale breaks
			NScale xScale = m_Chart.Axes[ENCartesianAxis.PrimaryX].Scale;

			m_FirstHorzScaleBreak = CreateCustomScaleBreak(NColor.Orange, new NRange(10, 20));
			xScale.ScaleBreaks.Add(m_FirstHorzScaleBreak);

			m_SecondHorzScaleBreak = CreateCustomScaleBreak(NColor.Green, new NRange(80, 90));
			xScale.ScaleBreaks.Add(m_SecondHorzScaleBreak);

			NScale yScale = m_Chart.Axes[ENCartesianAxis.PrimaryY].Scale;

            // add interlaced stripe for Y axis
            NScaleStrip stripStyle = new NScaleStrip(new NColorFill(NColor.Beige), null, true, 0, 0, 1, 1);
            stripStyle.Interlaced = true;
            yScale.Strips.Add(stripStyle);

            m_FirstVertScaleBreak = CreateCustomScaleBreak(NColor.Red, new NRange(10, 20));
			yScale.ScaleBreaks.Add(m_FirstVertScaleBreak);

			m_SecondVertScaleBreak = CreateCustomScaleBreak(NColor.Blue, new NRange(80, 90));
			yScale.ScaleBreaks.Add(m_SecondVertScaleBreak);

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

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

			stack.Add(new  NLabel("First Horizontal Scale Break"));

			NNumericUpDown firstHScaleBreakBegin = new NNumericUpDown();
			firstHScaleBreakBegin.ValueChanged += OnFirstHScaleBreakBeginValueChanged;
			stack.Add(NPairBox.Create("Begin:", firstHScaleBreakBegin));

			NNumericUpDown firstHScaleBreakEnd = new NNumericUpDown();
			firstHScaleBreakEnd.ValueChanged += OnFirstHScaleBreakEndValueChanged;
			stack.Add(NPairBox.Create("End:", firstHScaleBreakEnd));

			stack.Add(new  NLabel("Second Horizontal Scale Break"));

			NNumericUpDown secondHScaleBreakBegin = new NNumericUpDown();
			secondHScaleBreakBegin.ValueChanged += OnSecondHScaleBreakBeginValueChanged;
			stack.Add(NPairBox.Create("Begin:", secondHScaleBreakBegin));

			NNumericUpDown secondHScaleBreakEnd = new NNumericUpDown();
			secondHScaleBreakEnd.ValueChanged += OnSecondHScaleBreakEndValueChanged;
			stack.Add(NPairBox.Create("End:", secondHScaleBreakEnd));

			stack.Add(new NLabel("First Vertical Scale Break"));

			NNumericUpDown firstVScaleBreakBegin = new NNumericUpDown();
			firstVScaleBreakBegin.ValueChanged += OnFirstVScaleBreakBeginValueChanged;
			stack.Add(NPairBox.Create("Begin:", firstVScaleBreakBegin));

			NNumericUpDown firstVScaleBreakEnd = new NNumericUpDown();
			firstVScaleBreakEnd.ValueChanged += OnFirstVScaleBreakEndValueChanged;
			stack.Add(NPairBox.Create("End:", firstVScaleBreakEnd));

			stack.Add(new NLabel("Second Vertical Scale Break"));

			NNumericUpDown secondVScaleBreakBegin = new NNumericUpDown();
			secondVScaleBreakBegin.ValueChanged += OnSecondVScaleBreakBeginValueChanged;
			stack.Add(NPairBox.Create("Begin:", secondVScaleBreakBegin));

			NNumericUpDown secondVScaleBreakEnd = new NNumericUpDown();
			secondVScaleBreakEnd.ValueChanged += OnSecondVScaleBreakEndValueChanged;
			stack.Add(NPairBox.Create("End:", secondVScaleBreakEnd));

			firstHScaleBreakBegin.Value = 10;
			firstHScaleBreakEnd.Value = 20;

			secondHScaleBreakBegin.Value = 80;
			secondHScaleBreakEnd.Value = 90;

			firstVScaleBreakBegin.Value = 10;
			firstVScaleBreakEnd.Value = 20;

			secondVScaleBreakBegin.Value = 80;
			secondVScaleBreakEnd.Value = 90;
		
			return boxGroup;
		}
		public string GetExampleDescription()
		{
			return @"

This example demonstrates how to add custom scale breaks.

"; } /// /// Gets the relevant documentation links for the example /// /// public (string Name, string Url)[] GetDocumentationUrls() { return new[] { ("Scale Breaks", "https://www.nevron.com/docs/openvision/scale-breaks.html"), ("Scales Overview", "https://www.nevron.com/docs/openvision/scales-overview.html"), ("Common Axis Functionality", "https://www.nevron.com/docs/openvision/chart-common-axis-functionality.html"), }; } #endregion #region Implementation private NCustomScaleBreak CreateCustomScaleBreak(NColor color, NRange range) { NCustomScaleBreak scaleBreak = new NCustomScaleBreak(); scaleBreak.Fill = new NColorFill(new NColor(color, 124)); scaleBreak.Length = 10; scaleBreak.Range = range; return scaleBreak; } #endregion #region Event Handlers void OnSecondVScaleBreakEndValueChanged(NValueChangeEventArgs arg) { m_SecondVertScaleBreak.Range = new NRange(m_SecondVertScaleBreak.Range.Begin, ((NNumericUpDown)arg.TargetNode).Value); } void OnSecondVScaleBreakBeginValueChanged(NValueChangeEventArgs arg) { m_SecondVertScaleBreak.Range = new NRange(((NNumericUpDown)arg.TargetNode).Value, m_SecondVertScaleBreak.Range.End); } void OnFirstVScaleBreakEndValueChanged(NValueChangeEventArgs arg) { m_FirstVertScaleBreak.Range = new NRange(m_FirstVertScaleBreak.Range.Begin, ((NNumericUpDown)arg.TargetNode).Value); } void OnFirstVScaleBreakBeginValueChanged(NValueChangeEventArgs arg) { m_FirstVertScaleBreak.Range = new NRange(((NNumericUpDown)arg.TargetNode).Value, m_FirstVertScaleBreak.Range.End); } void OnSecondHScaleBreakEndValueChanged(NValueChangeEventArgs arg) { m_SecondHorzScaleBreak.Range = new NRange(m_SecondHorzScaleBreak.Range.Begin, ((NNumericUpDown)arg.TargetNode).Value); } void OnSecondHScaleBreakBeginValueChanged(NValueChangeEventArgs arg) { m_SecondHorzScaleBreak.Range = new NRange(((NNumericUpDown)arg.TargetNode).Value, m_SecondHorzScaleBreak.Range.End); } void OnFirstHScaleBreakEndValueChanged(NValueChangeEventArgs arg) { m_FirstHorzScaleBreak.Range = new NRange(m_FirstHorzScaleBreak.Range.Begin, ((NNumericUpDown)arg.TargetNode).Value); } void OnFirstHScaleBreakBeginValueChanged(NValueChangeEventArgs arg) { m_FirstHorzScaleBreak.Range = new NRange(((NNumericUpDown)arg.TargetNode).Value, m_FirstHorzScaleBreak.Range.End); } #endregion #region Fields NCartesianChart m_Chart; NCustomScaleBreak m_FirstHorzScaleBreak; NCustomScaleBreak m_SecondHorzScaleBreak; NCustomScaleBreak m_FirstVertScaleBreak; NCustomScaleBreak m_SecondVertScaleBreak; #endregion #region Static Methods #endregion #region Constants #endregion #region Nested Types #endregion } }

Download a fully functional C# (.cs) Custom Scale Breaks Example for WinForms Solution

VB.NET Custom Scale Breaks 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 - NCustomScaleBreaksExample"

        ' 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 = "Custom Scale Breaks"

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

            ' configure axes
            m_Chart.SetPredefinedCartesianAxes(ENPredefinedCartesianAxis.XYLinear)

            Dim random As Random = New Random()

            ' create three random point series
            For i = 0 To 2
                Dim point As NPointSeries = New NPointSeries()
                point.UseXValues = True

                point.DataLabelStyle = New NDataLabelStyle(False)
                point.Size = 5

                ' fill in some random data
                For j = 0 To 29
                    point.DataPoints.Add(New NPointDataPoint(5 + random.Next(90), 5 + random.Next(90)))
                Next

                m_Chart.Series.Add(point)
            Next

            ' create scale breaks
            Dim xScale As NScale = m_Chart.Axes(ENCartesianAxis.PrimaryX).Scale

            m_FirstHorzScaleBreak = CreateCustomScaleBreak(NColor.Orange, New NRange(10, 20))
            xScale.ScaleBreaks.Add(m_FirstHorzScaleBreak)

            m_SecondHorzScaleBreak = CreateCustomScaleBreak(NColor.Green, New NRange(80, 90))
            xScale.ScaleBreaks.Add(m_SecondHorzScaleBreak)

            Dim yScale As NScale = m_Chart.Axes(ENCartesianAxis.PrimaryY).Scale

            ' add interlaced stripe for Y axis
            Dim stripStyle As NScaleStrip = New NScaleStrip(New NColorFill(NColor.Beige), Nothing, True, 0, 0, 1, 1)
            stripStyle.Interlaced = True
            yScale.Strips.Add(stripStyle)

            m_FirstVertScaleBreak = CreateCustomScaleBreak(NColor.Red, New NRange(10, 20))
            yScale.ScaleBreaks.Add(m_FirstVertScaleBreak)

            m_SecondVertScaleBreak = CreateCustomScaleBreak(NColor.Blue, New NRange(80, 90))
            yScale.ScaleBreaks.Add(m_SecondVertScaleBreak)

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

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

            stack.Add(New NLabel("First Horizontal Scale Break"))

            Dim firstHScaleBreakBegin As NNumericUpDown = New NNumericUpDown()
            firstHScaleBreakBegin.ValueChanged += AddressOf OnFirstHScaleBreakBeginValueChanged
            stack.Add(NPairBox.Create("Begin:", firstHScaleBreakBegin))

            Dim firstHScaleBreakEnd As NNumericUpDown = New NNumericUpDown()
            firstHScaleBreakEnd.ValueChanged += AddressOf OnFirstHScaleBreakEndValueChanged
            stack.Add(NPairBox.Create("End:", firstHScaleBreakEnd))

            stack.Add(New NLabel("Second Horizontal Scale Break"))

            Dim secondHScaleBreakBegin As NNumericUpDown = New NNumericUpDown()
            secondHScaleBreakBegin.ValueChanged += AddressOf OnSecondHScaleBreakBeginValueChanged
            stack.Add(NPairBox.Create("Begin:", secondHScaleBreakBegin))

            Dim secondHScaleBreakEnd As NNumericUpDown = New NNumericUpDown()
            secondHScaleBreakEnd.ValueChanged += AddressOf OnSecondHScaleBreakEndValueChanged
            stack.Add(NPairBox.Create("End:", secondHScaleBreakEnd))

            stack.Add(New NLabel("First Vertical Scale Break"))

            Dim firstVScaleBreakBegin As NNumericUpDown = New NNumericUpDown()
            firstVScaleBreakBegin.ValueChanged += AddressOf OnFirstVScaleBreakBeginValueChanged
            stack.Add(NPairBox.Create("Begin:", firstVScaleBreakBegin))

            Dim firstVScaleBreakEnd As NNumericUpDown = New NNumericUpDown()
            firstVScaleBreakEnd.ValueChanged += AddressOf OnFirstVScaleBreakEndValueChanged
            stack.Add(NPairBox.Create("End:", firstVScaleBreakEnd))

            stack.Add(New NLabel("Second Vertical Scale Break"))

            Dim secondVScaleBreakBegin As NNumericUpDown = New NNumericUpDown()
            secondVScaleBreakBegin.ValueChanged += AddressOf OnSecondVScaleBreakBeginValueChanged
            stack.Add(NPairBox.Create("Begin:", secondVScaleBreakBegin))

            Dim secondVScaleBreakEnd As NNumericUpDown = New NNumericUpDown()
            secondVScaleBreakEnd.ValueChanged += AddressOf OnSecondVScaleBreakEndValueChanged
            stack.Add(NPairBox.Create("End:", secondVScaleBreakEnd))

            firstHScaleBreakBegin.Value = 10
            firstHScaleBreakEnd.Value = 20

            secondHScaleBreakBegin.Value = 80
            secondHScaleBreakEnd.Value = 90

            firstVScaleBreakBegin.Value = 10
            firstVScaleBreakEnd.Value = 20

            secondVScaleBreakBegin.Value = 80
            secondVScaleBreakEnd.Value = 90

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

This example demonstrates how to add custom scale breaks.

" End Function ''' ''' Gets the relevant documentation links for the example ''' ''' Public Function GetDocumentationUrls() As (String, String)() Return {("Scale Breaks", "https://www.nevron.com/docs/openvision/scale-breaks.html"), ("Scales Overview", "https://www.nevron.com/docs/openvision/scales-overview.html"), ("Common Axis Functionality", "https://www.nevron.com/docs/openvision/chart-common-axis-functionality.html")} End Function #End Region #Region "Implementation" Private Function CreateCustomScaleBreak(color As NColor, range As NRange) As NCustomScaleBreak Dim scaleBreak As NCustomScaleBreak = New NCustomScaleBreak() scaleBreak.Fill = New NColorFill(New NColor(color, 124)) scaleBreak.Length = 10 scaleBreak.Range = range Return scaleBreak End Function #End Region #Region "Event Handlers" Private Sub OnSecondVScaleBreakEndValueChanged(arg As NValueChangeEventArgs) m_SecondVertScaleBreak.Range = New NRange(m_SecondVertScaleBreak.Range.Begin, CType(arg.TargetNode, NNumericUpDown).Value) End Sub Private Sub OnSecondVScaleBreakBeginValueChanged(arg As NValueChangeEventArgs) m_SecondVertScaleBreak.Range = New NRange(CType(arg.TargetNode, NNumericUpDown).Value, m_SecondVertScaleBreak.Range.End) End Sub Private Sub OnFirstVScaleBreakEndValueChanged(arg As NValueChangeEventArgs) m_FirstVertScaleBreak.Range = New NRange(m_FirstVertScaleBreak.Range.Begin, CType(arg.TargetNode, NNumericUpDown).Value) End Sub Private Sub OnFirstVScaleBreakBeginValueChanged(arg As NValueChangeEventArgs) m_FirstVertScaleBreak.Range = New NRange(CType(arg.TargetNode, NNumericUpDown).Value, m_FirstVertScaleBreak.Range.End) End Sub Private Sub OnSecondHScaleBreakEndValueChanged(arg As NValueChangeEventArgs) m_SecondHorzScaleBreak.Range = New NRange(m_SecondHorzScaleBreak.Range.Begin, CType(arg.TargetNode, NNumericUpDown).Value) End Sub Private Sub OnSecondHScaleBreakBeginValueChanged(arg As NValueChangeEventArgs) m_SecondHorzScaleBreak.Range = New NRange(CType(arg.TargetNode, NNumericUpDown).Value, m_SecondHorzScaleBreak.Range.End) End Sub Private Sub OnFirstHScaleBreakEndValueChanged(arg As NValueChangeEventArgs) m_FirstHorzScaleBreak.Range = New NRange(m_FirstHorzScaleBreak.Range.Begin, CType(arg.TargetNode, NNumericUpDown).Value) End Sub Private Sub OnFirstHScaleBreakBeginValueChanged(arg As NValueChangeEventArgs) m_FirstHorzScaleBreak.Range = New NRange(CType(arg.TargetNode, NNumericUpDown).Value, m_FirstHorzScaleBreak.Range.End) End Sub #End Region #Region "Fields" Private m_Chart As NCartesianChart Private m_FirstHorzScaleBreak As NCustomScaleBreak Private m_SecondHorzScaleBreak As NCustomScaleBreak Private m_FirstVertScaleBreak As NCustomScaleBreak Private m_SecondVertScaleBreak As NCustomScaleBreak #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) Custom Scale Breaks Example for WinForms Solution