Axis Docking Percentages Example for WinForms

Axis Docking Percentages 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.

Axis Docking Percentages Example for WinForms Description

This example demonstrates how to adjust the area occupied by an axis when it is docked in an axis dock zone.


Axis Docking Percentagest Example

C# Axis Docking Percentages 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 - NAxisDockingPercentagestExample";

			// 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 Docking Percentages";

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

            // clear the default chart axes
            chart.Axes.Clear();

            m_RedAxis = CreateLinearAxis(ENCartesianAxisDockZone.Left, NColor.Red);
			chart.Axes.Add(m_RedAxis);

			m_GreenAxis = CreateLinearAxis(ENCartesianAxisDockZone.Right, NColor.Green);
			chart.Axes.Add(m_GreenAxis);

			// Add a custom vertical axis
			m_BlueAxis = CreateLinearAxis(ENCartesianAxisDockZone.Left, NColor.Blue);
			chart.Axes.Add(m_BlueAxis);

			chart.Axes.Add(NCartesianChart.CreateDockedAxis(ENCartesianAxisDockZone.Bottom, ENScaleType.Ordinal, true));

			// create three line series and dispay them on three vertical axes (red, green and blue axis)
			NLineSeries line1 = CreateLineSeries(NColor.Red, NColor.DarkRed, 10, 20);
			chart.Series.Add(line1);

			NLineSeries line2 = CreateLineSeries(NColor.Green, NColor.DarkGreen, 50, 100);
			chart.Series.Add(line2);

			NLineSeries line3 = CreateLineSeries(NColor.Blue, NColor.DarkBlue, 100, 200);
			chart.Series.Add(line3);

			line1.VerticalAxis = m_RedAxis;
			line2.VerticalAxis = m_GreenAxis;
			line3.VerticalAxis = m_BlueAxis;

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

			m_RedAxisEndPercentUpDown = new NNumericUpDown();
			m_RedAxisEndPercentUpDown.Minimum = 10;
			m_RedAxisEndPercentUpDown.Maximum = 60;
			m_RedAxisEndPercentUpDown.ValueChanged += OnRedAxisEndPercentUpDownValueChanged;
			stack.Add(NPairBox.Create("Red Axis End Percent:", m_RedAxisEndPercentUpDown));

			m_BlueAxisBeginPercentUpDown = new NNumericUpDown();
			m_BlueAxisBeginPercentUpDown.Minimum = 20;
			m_BlueAxisBeginPercentUpDown.Maximum = 90;
			m_BlueAxisBeginPercentUpDown.ValueChanged += OnBlueAxisEndPercentUpDownValueChanged;
			stack.Add(NPairBox.Create("Blue Axis Begin Percent:", m_BlueAxisBeginPercentUpDown));

			m_RedAxisEndPercentUpDown.Value = 30;
			m_BlueAxisBeginPercentUpDown.Value = 70;

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

This example demonstrates how to adjust the area occupied by an axis when it is docked in an axis dock zone.

"; } /// /// Gets the relevant documentation links for the example /// /// public (string Name, string Url)[] GetDocumentationUrls() { return new[] { ("Cartesian Axes", "https://www.nevron.com/docs/openvision/cartesian-chart-axes.html"), ("Common Axis Functionality", "https://www.nevron.com/docs/openvision/chart-common-axis-functionality.html"), }; } #endregion #region Implementation private NCartesianAxis CreateLinearAxis(ENCartesianAxisDockZone dockZone, NColor color) { NCartesianAxis axis = new NCartesianAxis(); axis.Scale = CreateLinearScale(color); axis.Anchor = new NDockCartesianAxisAnchor(dockZone, false); return axis; } private NLinearScale CreateLinearScale(NColor color) { NLinearScale linearScale = new NLinearScale(); linearScale.Ruler.Stroke = new NStroke(1, color); linearScale.InnerMajorTicks.Stroke = new NStroke(color); linearScale.OuterMajorTicks.Stroke = new NStroke(color); linearScale.Labels.Style.TextStyle.Fill = new NColorFill(color); NScaleGridLines grid = new NScaleGridLines(); grid.Stroke.Color = color; grid.Visible = true; linearScale.MajorGridLines = grid; NScaleStrip strip = new NScaleStrip(); strip.Length = 1; strip.Interval = 1; strip.Fill = new NColorFill(new NColor(color, 50)); linearScale.Strips.Add(strip); return linearScale; } private NLineSeries CreateLineSeries(NColor lightColor, NColor color, int begin, int end) { // Add a line series NLineSeries line = new NLineSeries(); Random random = new Random(); for (int i = 0; i < 5; i++) { line.DataPoints.Add(new NLineDataPoint(random.Next(begin, end))); } line.Stroke = new NStroke(2, color); NDataLabelStyle dataLabelStyle = new NDataLabelStyle(); dataLabelStyle.Format = ""; dataLabelStyle.TextStyle.Background.Visible = false; dataLabelStyle.ArrowStroke.Width = 0; dataLabelStyle.ArrowLength = 10; dataLabelStyle.TextStyle.Font = new NFont("Arial", 8); dataLabelStyle.TextStyle.Background.Visible = true; line.DataLabelStyle = dataLabelStyle; NMarkerStyle markerStyle = new NMarkerStyle(); markerStyle.Visible = true; markerStyle.Border = new NStroke(color); markerStyle.Fill = new NColorFill(lightColor); markerStyle.Shape = ENPointShape3D.Ellipse; markerStyle.Size = new NSize(5, 5); line.MarkerStyle = markerStyle; return line; } #endregion #region Event Handlers void OnRedAxisEndPercentUpDownValueChanged(NValueChangeEventArgs arg) { m_BlueAxisBeginPercentUpDown.Minimum = m_RedAxisEndPercentUpDown.Value + 10; RecalcAxes(); } void OnBlueAxisEndPercentUpDownValueChanged(NValueChangeEventArgs arg) { m_RedAxisEndPercentUpDown.Maximum = m_BlueAxisBeginPercentUpDown.Value - 10; RecalcAxes(); } private void RecalcAxes() { int middleAxisBegin = (int)m_RedAxisEndPercentUpDown.Value; int middleAxisEnd = (int)m_BlueAxisBeginPercentUpDown.Value; // red axis m_RedAxis.Anchor.EndPercent = middleAxisBegin; // green axis m_GreenAxis.Anchor.BeginPercent = middleAxisBegin; m_GreenAxis.Anchor.EndPercent = middleAxisEnd; // blue axis m_BlueAxis.Anchor.BeginPercent = middleAxisEnd; } #endregion #region Fields NCartesianAxis m_RedAxis; NCartesianAxis m_GreenAxis; NCartesianAxis m_BlueAxis; NNumericUpDown m_RedAxisEndPercentUpDown; NNumericUpDown m_BlueAxisBeginPercentUpDown; #endregion #region Static Methods #endregion #region Constants #endregion #region Nested Types #endregion } }

Download a fully functional C# (.cs) Axis Docking Percentages Example for WinForms Solution

VB.NET Axis Docking Percentages 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 - NAxisDockingPercentagestExample"

        ' 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 Docking Percentages"

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

            ' clear the default chart axes
            chart.Axes.Clear()

            m_RedAxis = CreateLinearAxis(ENCartesianAxisDockZone.Left, NColor.Red)
            chart.Axes.Add(m_RedAxis)

            m_GreenAxis = CreateLinearAxis(ENCartesianAxisDockZone.Right, NColor.Green)
            chart.Axes.Add(m_GreenAxis)

            ' Add a custom vertical axis
            m_BlueAxis = CreateLinearAxis(ENCartesianAxisDockZone.Left, NColor.Blue)
            chart.Axes.Add(m_BlueAxis)

            chart.Axes.Add(NCartesianChart.CreateDockedAxis(ENCartesianAxisDockZone.Bottom, ENScaleType.Ordinal, True))

            ' create three line series and dispay them on three vertical axes (red, green and blue axis)
            Dim line1 = CreateLineSeries(NColor.Red, NColor.DarkRed, 10, 20)
            chart.Series.Add(line1)

            Dim line2 = CreateLineSeries(NColor.Green, NColor.DarkGreen, 50, 100)
            chart.Series.Add(line2)

            Dim line3 = CreateLineSeries(NColor.Blue, NColor.DarkBlue, 100, 200)
            chart.Series.Add(line3)

            line1.VerticalAxis = m_RedAxis
            line2.VerticalAxis = m_GreenAxis
            line3.VerticalAxis = m_BlueAxis

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

            m_RedAxisEndPercentUpDown = New NNumericUpDown()
            m_RedAxisEndPercentUpDown.Minimum = 10
            m_RedAxisEndPercentUpDown.Maximum = 60
            Me.m_RedAxisEndPercentUpDown.ValueChanged += AddressOf OnRedAxisEndPercentUpDownValueChanged
            stack.Add(NPairBox.Create("Red Axis End Percent:", m_RedAxisEndPercentUpDown))

            m_BlueAxisBeginPercentUpDown = New NNumericUpDown()
            m_BlueAxisBeginPercentUpDown.Minimum = 20
            m_BlueAxisBeginPercentUpDown.Maximum = 90
            Me.m_BlueAxisBeginPercentUpDown.ValueChanged += AddressOf OnBlueAxisEndPercentUpDownValueChanged
            stack.Add(NPairBox.Create("Blue Axis Begin Percent:", m_BlueAxisBeginPercentUpDown))

            m_RedAxisEndPercentUpDown.Value = 30
            m_BlueAxisBeginPercentUpDown.Value = 70

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

This example demonstrates how to adjust the area occupied by an axis when it is docked in an axis dock zone.

" End Function ''' ''' Gets the relevant documentation links for the example ''' ''' Public Function GetDocumentationUrls() As (String, String)() Return {("Cartesian Axes", "https://www.nevron.com/docs/openvision/cartesian-chart-axes.html"), ("Common Axis Functionality", "https://www.nevron.com/docs/openvision/chart-common-axis-functionality.html")} End Function #End Region #Region "Implementation" Private Function CreateLinearAxis(dockZone As ENCartesianAxisDockZone, color As NColor) As NCartesianAxis Dim axis As NCartesianAxis = New NCartesianAxis() axis.Scale = CreateLinearScale(color) axis.Anchor = New NDockCartesianAxisAnchor(dockZone, False) Return axis End Function Private Function CreateLinearScale(color As NColor) As NLinearScale Dim linearScale As NLinearScale = New NLinearScale() linearScale.Ruler.Stroke = New NStroke(1, color) linearScale.InnerMajorTicks.Stroke = New NStroke(color) linearScale.OuterMajorTicks.Stroke = New NStroke(color) linearScale.Labels.Style.TextStyle.Fill = New NColorFill(color) Dim grid As NScaleGridLines = New NScaleGridLines() grid.Stroke.Color = color grid.Visible = True linearScale.MajorGridLines = grid Dim strip As NScaleStrip = New NScaleStrip() strip.Length = 1 strip.Interval = 1 strip.Fill = New NColorFill(New NColor(color, 50)) linearScale.Strips.Add(strip) Return linearScale End Function Private Function CreateLineSeries(lightColor As NColor, color As NColor, begin As Integer, [end] As Integer) As NLineSeries ' Add a line series Dim line As NLineSeries = New NLineSeries() Dim random As Random = New Random() For i = 0 To 4 line.DataPoints.Add(New NLineDataPoint(random.Next(begin, [end]))) Next line.Stroke = New NStroke(2, color) Dim dataLabelStyle As NDataLabelStyle = New NDataLabelStyle() dataLabelStyle.Format = "" dataLabelStyle.TextStyle.Background.Visible = False dataLabelStyle.ArrowStroke.Width = 0 dataLabelStyle.ArrowLength = 10 dataLabelStyle.TextStyle.Font = New NFont("Arial", 8) dataLabelStyle.TextStyle.Background.Visible = True line.DataLabelStyle = dataLabelStyle Dim markerStyle As NMarkerStyle = New NMarkerStyle() markerStyle.Visible = True markerStyle.Border = New NStroke(color) markerStyle.Fill = New NColorFill(lightColor) markerStyle.Shape = ENPointShape3D.Ellipse markerStyle.Size = New NSize(5, 5) line.MarkerStyle = markerStyle Return line End Function #End Region #Region "Event Handlers" Private Sub OnRedAxisEndPercentUpDownValueChanged(arg As NValueChangeEventArgs) m_BlueAxisBeginPercentUpDown.Minimum = m_RedAxisEndPercentUpDown.Value + 10 RecalcAxes() End Sub Private Sub OnBlueAxisEndPercentUpDownValueChanged(arg As NValueChangeEventArgs) m_RedAxisEndPercentUpDown.Maximum = m_BlueAxisBeginPercentUpDown.Value - 10 RecalcAxes() End Sub Private Sub RecalcAxes() Dim middleAxisBegin As Integer = m_RedAxisEndPercentUpDown.Value Dim middleAxisEnd As Integer = m_BlueAxisBeginPercentUpDown.Value ' red axis m_RedAxis.Anchor.EndPercent = middleAxisBegin ' green axis m_GreenAxis.Anchor.BeginPercent = middleAxisBegin m_GreenAxis.Anchor.EndPercent = middleAxisEnd ' blue axis m_BlueAxis.Anchor.BeginPercent = middleAxisEnd End Sub #End Region #Region "Fields" Private m_RedAxis As NCartesianAxis Private m_GreenAxis As NCartesianAxis Private m_BlueAxis As NCartesianAxis Private m_RedAxisEndPercentUpDown As NNumericUpDown Private m_BlueAxisBeginPercentUpDown 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) Axis Docking Percentages Example for WinForms Solution

Related Documentation Links