View Range 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.

View Range Example for WinForms Description

This example demonstrates how to explicitly set the axis view range.


Axis View Range Example

C# View Range 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 - NAxisViewRangeExample";

			// 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 = "Axis View Range";

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

            // configure axes
            m_Chart.SetPredefinedCartesianAxes(ENPredefinedCartesianAxis.XOrdinalYLinear);

            m_Chart.Axes[ENCartesianAxis.PrimaryY].ClipMode = ENAxisClipMode.Auto;

            // configure scale
            NLinearScale yScale = (NLinearScale)m_Chart.Axes[ENCartesianAxis.PrimaryY].Scale;
            yScale.ViewRangeInflateMode = ENScaleViewRangeInflateMode.MajorTick;
            yScale.MinTickDistance = 30;

            // add an interlaced strip to the Y axis
            NScaleStrip interlacedStrip = new NScaleStrip();
            interlacedStrip.Interlaced = true;
            interlacedStrip.Fill = new NColorFill(NColor.Beige);
            yScale.Strips.Add(interlacedStrip);

            OnChangeDataButtonClick(null);

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

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

            m_ViewRangeMode = new NComboBox();
            m_ViewRangeMode.Items.FillFromEnum();
            m_ViewRangeMode.SelectedIndexChanged += OnViewRangeModeSelectedIndexChanged;
            stack.Add(NPairBox.Create("View Range Mode:", m_ViewRangeMode));

            m_ViewRangeMinValue = new NNumericUpDown();
            m_ViewRangeMinValue.ValueChanged += OnViewRangeMinValueChanged;
            stack.Add(NPairBox.Create("View Range Min:", m_ViewRangeMinValue));

            m_ViewRangeMaxValue = new NNumericUpDown();
            m_ViewRangeMaxValue.ValueChanged += OnViewRangMaxValueChanged;
            stack.Add(NPairBox.Create("View Range Max:", m_ViewRangeMaxValue));

            NButton changeDataButton = new NButton("Change Data");
            changeDataButton.Click += OnChangeDataButtonClick;
            stack.Add(changeDataButton);

            m_ViewRangeMode.SelectedIndex = (int)ENAxisViewRangeMode.Auto;
            m_ViewRangeMinValue.Value = 20;
            m_ViewRangeMaxValue.Value = 80;

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

This example demonstrates how to explicitly set the axis view range.

"; } /// /// Gets the relevant documentation links for the example /// /// public (string Name, string Url)[] GetDocumentationUrls() { return new[] { ("Common Axis Functionality", "https://www.nevron.com/docs/openvision/chart-common-axis-functionality.html"), ("Cartesian Axes", "https://www.nevron.com/docs/openvision/cartesian-chart-axes.html"), }; } #endregion #region Implementation #endregion #region Event Handlers private void OnViewRangeMinValueChanged(NValueChangeEventArgs arg) { m_Chart.Axes[ENCartesianAxis.PrimaryY].MinViewRangeValue = (double)m_ViewRangeMinValue.Value; } private void OnViewRangMaxValueChanged(NValueChangeEventArgs arg) { m_Chart.Axes[ENCartesianAxis.PrimaryY].MaxViewRangeValue = (double)m_ViewRangeMaxValue.Value; } private void OnViewRangeModeSelectedIndexChanged(NValueChangeEventArgs arg) { ENAxisViewRangeMode viewRangeMode = (ENAxisViewRangeMode)m_ViewRangeMode.SelectedIndex; m_Chart.Axes[ENCartesianAxis.PrimaryY].ViewRangeMode = viewRangeMode; switch (viewRangeMode) { case ENAxisViewRangeMode.Auto: m_ViewRangeMinValue.Enabled = false; m_ViewRangeMaxValue.Enabled = false; break; case ENAxisViewRangeMode.FixedMin: m_ViewRangeMinValue.Enabled = true; m_ViewRangeMaxValue.Enabled = false; break; case ENAxisViewRangeMode.FixedMax: m_ViewRangeMinValue.Enabled = false; m_ViewRangeMaxValue.Enabled = true; break; case ENAxisViewRangeMode.FixedRange: m_ViewRangeMinValue.Enabled = true; m_ViewRangeMaxValue.Enabled = true; break; } } private void OnChangeDataButtonClick(NEventArgs arg) { m_Chart.Series.Clear(); // setup bar series NBarSeries bar = new NBarSeries(); m_Chart.Series.Add(bar); bar.DataLabelStyle = new NDataLabelStyle(false); bar.Stroke = new NStroke(1.5f, NColor.DarkGreen); // fill in some data so that it contains several peaks of data Random random = new Random(); for (int i = 0; i < 25; i++) { double value = random.NextDouble() * 100; NBarDataPoint dataPoint = new NBarDataPoint(value); bar.DataPoints.Add(dataPoint); } } #endregion #region Fields NCartesianChart m_Chart; NComboBox m_ViewRangeMode; NNumericUpDown m_ViewRangeMinValue; NNumericUpDown m_ViewRangeMaxValue; #endregion #region Static Methods #endregion #region Constants #endregion #region Nested Types #endregion } }

Download a fully functional C# (.cs) View Range Example for WinForms Solution

VB.NET View Range 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 - NAxisViewRangeExample"

        ' 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 = "Axis View Range"

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

            ' configure axes
            m_Chart.SetPredefinedCartesianAxes(ENPredefinedCartesianAxis.XOrdinalYLinear)

            m_Chart.Axes(ENCartesianAxis.PrimaryY).ClipMode = ENAxisClipMode.Auto

            ' configure scale
            Dim yScale As NLinearScale = m_Chart.Axes(ENCartesianAxis.PrimaryY).Scale
            yScale.ViewRangeInflateMode = ENScaleViewRangeInflateMode.MajorTick
            yScale.MinTickDistance = 30

            ' add an interlaced strip to the Y axis
            Dim interlacedStrip As NScaleStrip = New NScaleStrip()
            interlacedStrip.Interlaced = True
            interlacedStrip.Fill = New NColorFill(NColor.Beige)
            yScale.Strips.Add(interlacedStrip)

            OnChangeDataButtonClick(Nothing)

            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)

            m_ViewRangeMode = New NComboBox()
            m_ViewRangeMode.Items.FillFromEnum(Of ENAxisViewRangeMode)()
            Me.m_ViewRangeMode.SelectedIndexChanged += AddressOf OnViewRangeModeSelectedIndexChanged
            stack.Add(NPairBox.Create("View Range Mode:", m_ViewRangeMode))

            m_ViewRangeMinValue = New NNumericUpDown()
            Me.m_ViewRangeMinValue.ValueChanged += AddressOf OnViewRangeMinValueChanged
            stack.Add(NPairBox.Create("View Range Min:", m_ViewRangeMinValue))

            m_ViewRangeMaxValue = New NNumericUpDown()
            Me.m_ViewRangeMaxValue.ValueChanged += AddressOf OnViewRangMaxValueChanged
            stack.Add(NPairBox.Create("View Range Max:", m_ViewRangeMaxValue))

            Dim changeDataButton As NButton = New NButton("Change Data")
            changeDataButton.Click += AddressOf OnChangeDataButtonClick
            stack.Add(changeDataButton)

            m_ViewRangeMode.SelectedIndex = CInt(ENAxisViewRangeMode.Auto)
            m_ViewRangeMinValue.Value = 20
            m_ViewRangeMaxValue.Value = 80

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

This example demonstrates how to explicitly set the axis view range.

" End Function ''' ''' Gets the relevant documentation links for the example ''' ''' Public Function GetDocumentationUrls() As (String, String)() Return {("Common Axis Functionality", "https://www.nevron.com/docs/openvision/chart-common-axis-functionality.html"), ("Cartesian Axes", "https://www.nevron.com/docs/openvision/cartesian-chart-axes.html")} End Function #End Region #Region "Implementation" #End Region #Region "Event Handlers" Private Sub OnViewRangeMinValueChanged(arg As NValueChangeEventArgs) m_Chart.Axes(ENCartesianAxis.PrimaryY).MinViewRangeValue = m_ViewRangeMinValue.Value End Sub Private Sub OnViewRangMaxValueChanged(arg As NValueChangeEventArgs) m_Chart.Axes(ENCartesianAxis.PrimaryY).MaxViewRangeValue = m_ViewRangeMaxValue.Value End Sub Private Sub OnViewRangeModeSelectedIndexChanged(arg As NValueChangeEventArgs) Dim viewRangeMode As ENAxisViewRangeMode = m_ViewRangeMode.SelectedIndex m_Chart.Axes(ENCartesianAxis.PrimaryY).ViewRangeMode = viewRangeMode Select Case viewRangeMode Case ENAxisViewRangeMode.Auto m_ViewRangeMinValue.Enabled = False m_ViewRangeMaxValue.Enabled = False Case ENAxisViewRangeMode.FixedMin m_ViewRangeMinValue.Enabled = True m_ViewRangeMaxValue.Enabled = False Case ENAxisViewRangeMode.FixedMax m_ViewRangeMinValue.Enabled = False m_ViewRangeMaxValue.Enabled = True Case ENAxisViewRangeMode.FixedRange m_ViewRangeMinValue.Enabled = True m_ViewRangeMaxValue.Enabled = True End Select End Sub Private Sub OnChangeDataButtonClick(arg As NEventArgs) m_Chart.Series.Clear() ' setup bar series Dim bar As NBarSeries = New NBarSeries() m_Chart.Series.Add(bar) bar.DataLabelStyle = New NDataLabelStyle(False) bar.Stroke = New NStroke(1.5F, NColor.DarkGreen) ' fill in some data so that it contains several peaks of data Dim random As Random = New Random() For i = 0 To 24 Dim value As Double = random.NextDouble() * 100 Dim dataPoint As NBarDataPoint = New NBarDataPoint(value) bar.DataPoints.Add(dataPoint) Next End Sub #End Region #Region "Fields" Private m_Chart As NCartesianChart Private m_ViewRangeMode As NComboBox Private m_ViewRangeMinValue As NNumericUpDown Private m_ViewRangeMaxValue As NNumericUpDown #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) View Range Example for WinForms Solution

Related Documentation Links