Custom Labels and TickMarks Example for WinForms

Custom Labels and TickMarks Example for WinForms

Nevron NOV Gauge for WinForms ships with hundreds of examples with full source code, as part of the Nevron Open Vision Suite. All WinForms Gauge 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 Labels and TickMarks Example for WinForms Description

This example demonstrates how to use a minimum scale pin to define a pointer's off position.


Scales Custom Labels Example

C# Custom Labels and TickMarks Example Code for Nevron Gauge 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 - NScalesCustomLabelsExample";

			// 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()
        {
            NStackPanel stack = new NStackPanel();

            NStackPanel controlStack = new NStackPanel();
            controlStack.Padding = new NMargins(20);
            stack.Add(controlStack);

            // create the radial gauge
            m_RadialGauge = new NRadialGauge();
            m_RadialGauge.PreferredSize = defaultRadialGaugeSize;
            m_RadialGauge.Dial = new NDial(ENDialShape.CutCircle, new NEdgeDialRim());
            m_RadialGauge.NeedleCap.Visible = false;
            controlStack.Add(m_RadialGauge);

            // add axis 
            NGaugeAxis axis = new NGaugeAxis();
            m_RadialGauge.Axes.Clear();
            m_RadialGauge.Axes.Add(axis);
            axis.Range = new NRange(0, 20);
            axis.Anchor = new NDockGaugeAxisAnchor(ENGaugeAxisDockZone.Top, true, ENScaleOrientation.Left, 2f, 98f);

            // scale
            m_RadialGauge.SweepAngle = new NAngle(180, NUnit.Degree);
            m_RadialGauge.BeginAngle = new NAngle(-180, NUnit.Degree);

            // needle value 
            m_NeedleIndicator = new NNeedleValueIndicator();
            m_NeedleIndicator.ScaleAxis = axis;
            m_NeedleIndicator.Width = 12;
            m_NeedleIndicator.Fill = new NColorFill(NColor.Red);
            m_NeedleIndicator.OffsetFromScale = 15;
            m_RadialGauge.Indicators.Add(m_NeedleIndicator);

            // Timer
            m_Timer = new NTimer();
            m_Timer.Interval = 800;
            m_Timer.Tick += OnTimerTick;
            m_Timer.Start();

            return stack;
        }


        /// 
        /// 
        /// 
        /// 
        public NWidget CreateExampleControls()
        {
            NStackPanel stack = new NStackPanel();

            NStackPanel propertyStack = new NStackPanel();
            stack.Add(new NUniSizeBoxGroup(propertyStack));

            m_LabelsTypeRadioGroup = new NRadioButtonGroup();
            m_LabelsTypeRadioGroup.SelectedIndexChanged += OnLabelsTypeRadioGroupIndexChanged;
            
            NStackPanel radioStack = new NStackPanel();
            m_LabelsTypeRadioGroup.Content = radioStack;

            radioStack.Add(new NRadioButton("Standart Labels"));
            radioStack.Add(new NRadioButton("Custom Labels"));
            radioStack.Add(new NRadioButton("Both"));

            m_LabelsTypeRadioGroup.SelectedIndex = 0;

            ((NRadioButton)radioStack[0]).Checked = true;
            stack.Add(m_LabelsTypeRadioGroup);
         
            return stack;
        }
              
        public string GetExampleDescription()
        {
            return @"

This example demonstrates how to use a minimum scale pin to define a pointer's off position.

"; } /// /// Gets the relevant documentation links for the example /// /// public (string Name, string Url)[] GetDocumentationUrls() { return new[] { ("Scale Custom Labels", "https://www.nevron.com/docs/openvision/scale-custom-labels.html"), ("Gauges Axes", "https://www.nevron.com/docs/openvision/gauges-axes.html"), }; } #endregion #region Implementation /// /// Adds custom labels to the scle /// /// private void AddCustomLabels(NLinearScale scale) { scale.CustomLabelOverlapResolveLayouts = new NDomArray(new ENLevelLabelsLayout[] { ENLevelLabelsLayout.RemoveOverlap, ENLevelLabelsLayout.AutoScale }); scale.CustomLabels.Add(CreateCustomLabel(0, "E")); scale.CustomLabels.Add(CreateCustomLabel(10, "1/2")); scale.CustomLabels.Add(CreateCustomLabel(20, "F")); } /// /// Creates a custom label give the specified value and text /// /// /// /// private NCustomValueLabel CreateCustomLabel(double value, string text) { NCustomValueLabel label = new NCustomValueLabel(value, text); label.LabelStyle.ZOrder = 1; label.LabelStyle.TextStyle.Font = new NFont("Microsoft Sans Serif", 15, ENFontStyle.Bold); label.LabelStyle.TextStyle.Fill = new NColorFill(NColor.Black); return label; } #endregion #region Event Handlers private void OnLabelsTypeRadioGroupIndexChanged(NValueChangeEventArgs arg) { int selectedIndex = m_LabelsTypeRadioGroup.SelectedIndex; // scale NLinearScale scale = new NLinearScale(); m_RadialGauge.Axes[0].Scale = scale; scale.SetPredefinedScale(ENPredefinedScaleStyle.Presentation); scale.Labels.Style.TextStyle.Font = new NFont("Microsoft Sans Serif", 15, ENFontStyle.Bold); scale.Labels.Style.TextStyle.Fill = new NColorFill(NColor.Black); scale.MajorTickMode = ENMajorTickMode.AutoMaxCount; scale.OuterMinorTicks.Visible = true; scale.OuterMajorTicks.Width = 7; scale.OuterMajorTicks.Fill = new NColorFill(NColor.Black); scale.MinorTickCount = 3; scale.OuterMinorTicks.Fill = new NColorFill(NColor.Gray); scale.Title.Text = "GAS"; scale.Title.TextStyle = new NTextStyle(NColor.Red); scale.Title.RulerAlignment = ENHorizontalAlignment.Center; scale.Title.ContentAlignment = ENContentAlignment.BottomCenter; switch (selectedIndex) { case 0: // Standard labels break; case 1: // Custom labels scale.Labels.Visible = false; scale.CreateNewLevelForCustomLabels = true; AddCustomLabels(scale); break; case 2: // Both // add custom labels scale.CreateNewLevelForCustomLabels = false; AddCustomLabels(scale); break; } } /// /// Timer tick event /// private void OnTimerTick() { // update the indicator m_FirstIndicatorAngle += 0.02; double value = 50.0 - Math.Cos(m_FirstIndicatorAngle) * 50.0; m_NeedleIndicator.Value = value; } #endregion #region Fields NRadialGauge m_RadialGauge; NNeedleValueIndicator m_NeedleIndicator; NRadioButtonGroup m_LabelsTypeRadioGroup; NTimer m_Timer; double m_FirstIndicatorAngle; #endregion #region Static Methods #endregion #region Constants private static readonly NSize defaultRadialGaugeSize = new NSize(300, 300); #endregion #region Nested Types #endregion } }

Download a fully functional C# (.cs) Custom Labels and TickMarks Example for WinForms Solution

VB.NET Custom Labels and TickMarks Example Code for Nevron Gauge 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 - NScalesCustomLabelsExample"

        ' 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 stack As NStackPanel = New NStackPanel()

            Dim controlStack As NStackPanel = New NStackPanel()
            controlStack.Padding = New NMargins(20)
            stack.Add(controlStack)

            ' create the radial gauge
            m_RadialGauge = New NRadialGauge()
            m_RadialGauge.PreferredSize = defaultRadialGaugeSize
            m_RadialGauge.Dial = New NDial(ENDialShape.CutCircle, New NEdgeDialRim())
            m_RadialGauge.NeedleCap.Visible = False
            controlStack.Add(m_RadialGauge)

            ' add axis 
            Dim axis As NGaugeAxis = New NGaugeAxis()
            m_RadialGauge.Axes.Clear()
            m_RadialGauge.Axes.Add(axis)
            axis.Range = New NRange(0, 20)
            axis.Anchor = New NDockGaugeAxisAnchor(ENGaugeAxisDockZone.Top, True, ENScaleOrientation.Left, 2F, 98F)

            ' scale
            m_RadialGauge.SweepAngle = New NAngle(180, NUnit.Degree)
            m_RadialGauge.BeginAngle = New NAngle(-180, NUnit.Degree)

            ' needle value 
            m_NeedleIndicator = New NNeedleValueIndicator()
            m_NeedleIndicator.ScaleAxis = axis
            m_NeedleIndicator.Width = 12
            m_NeedleIndicator.Fill = New NColorFill(NColor.Red)
            m_NeedleIndicator.OffsetFromScale = 15
            m_RadialGauge.Indicators.Add(m_NeedleIndicator)

            ' Timer
            m_Timer = New NTimer()
            m_Timer.Interval = 800
            Me.m_Timer.Tick += AddressOf OnTimerTick
            m_Timer.Start()

            Return stack
        End Function


        ''' 
        ''' 
        ''' 
        ''' 
        Public Function CreateExampleControls() As NWidget
            Dim stack As NStackPanel = New NStackPanel()

            Dim propertyStack As NStackPanel = New NStackPanel()
            stack.Add(New NUniSizeBoxGroup(propertyStack))

            m_LabelsTypeRadioGroup = New NRadioButtonGroup()
            Me.m_LabelsTypeRadioGroup.SelectedIndexChanged += AddressOf OnLabelsTypeRadioGroupIndexChanged

            Dim radioStack As NStackPanel = New NStackPanel()
            m_LabelsTypeRadioGroup.Content = radioStack

            radioStack.Add(New NRadioButton("Standart Labels"))
            radioStack.Add(New NRadioButton("Custom Labels"))
            radioStack.Add(New NRadioButton("Both"))

            m_LabelsTypeRadioGroup.SelectedIndex = 0

            CType(radioStack(0), NRadioButton).Checked = True
            stack.Add(m_LabelsTypeRadioGroup)

            Return stack
        End Function

        Public Function GetExampleDescription() As String
            Return "

This example demonstrates how to use a minimum scale pin to define a pointer's off position.

" End Function ''' ''' Gets the relevant documentation links for the example ''' ''' Public Function GetDocumentationUrls() As (String, String)() Return {("Scale Custom Labels", "https://www.nevron.com/docs/openvision/scale-custom-labels.html"), ("Gauges Axes", "https://www.nevron.com/docs/openvision/gauges-axes.html")} End Function #End Region #Region "Implementation" ''' ''' Adds custom labels to the scle ''' ''' Private Sub AddCustomLabels(scale As NLinearScale) scale.CustomLabelOverlapResolveLayouts = New NDomArray(Of ENLevelLabelsLayout)(New ENLevelLabelsLayout() {ENLevelLabelsLayout.RemoveOverlap, ENLevelLabelsLayout.AutoScale}) scale.CustomLabels.Add(CreateCustomLabel(0, "E")) scale.CustomLabels.Add(CreateCustomLabel(10, "1/2")) scale.CustomLabels.Add(CreateCustomLabel(20, "F")) End Sub ''' ''' Creates a custom label give the specified value and text ''' ''' ''' ''' Private Function CreateCustomLabel(value As Double, text As String) As NCustomValueLabel Dim label As NCustomValueLabel = New NCustomValueLabel(value, text) label.LabelStyle.ZOrder = 1 label.LabelStyle.TextStyle.Font = New NFont("Microsoft Sans Serif", 15, ENFontStyle.Bold) label.LabelStyle.TextStyle.Fill = New NColorFill(NColor.Black) Return label End Function #End Region #Region "Event Handlers" Private Sub OnLabelsTypeRadioGroupIndexChanged(arg As NValueChangeEventArgs) Dim selectedIndex = m_LabelsTypeRadioGroup.SelectedIndex ' scale Dim scale As NLinearScale = New NLinearScale() m_RadialGauge.Axes(0).Scale = scale scale.SetPredefinedScale(ENPredefinedScaleStyle.Presentation) scale.Labels.Style.TextStyle.Font = New NFont("Microsoft Sans Serif", 15, ENFontStyle.Bold) scale.Labels.Style.TextStyle.Fill = New NColorFill(NColor.Black) scale.MajorTickMode = ENMajorTickMode.AutoMaxCount scale.OuterMinorTicks.Visible = True scale.OuterMajorTicks.Width = 7 scale.OuterMajorTicks.Fill = New NColorFill(NColor.Black) scale.MinorTickCount = 3 scale.OuterMinorTicks.Fill = New NColorFill(NColor.Gray) scale.Title.Text = "GAS" scale.Title.TextStyle = New NTextStyle(NColor.Red) scale.Title.RulerAlignment = ENHorizontalAlignment.Center scale.Title.ContentAlignment = ENContentAlignment.BottomCenter Select Case selectedIndex Case 0 ' Standard labels Case 1 ' Custom labels scale.Labels.Visible = False scale.CreateNewLevelForCustomLabels = True AddCustomLabels(scale) Case 2 ' Both ' add custom labels scale.CreateNewLevelForCustomLabels = False AddCustomLabels(scale) End Select End Sub ''' ''' Timer tick event ''' Private Sub OnTimerTick() ' update the indicator m_FirstIndicatorAngle += 0.02 Dim value = 50.0 - Math.Cos(m_FirstIndicatorAngle) * 50.0 m_NeedleIndicator.Value = value End Sub #End Region #Region "Fields" Private m_RadialGauge As NRadialGauge Private m_NeedleIndicator As NNeedleValueIndicator Private m_LabelsTypeRadioGroup As NRadioButtonGroup Private m_Timer As NTimer Private m_FirstIndicatorAngle As Double #End Region #Region "Static Methods" #End Region #Region "Constants" Private Shared ReadOnly defaultRadialGaugeSize As NSize = New NSize(300, 300) #End Region #Region "Nested Types" #End Region End Class

Download a fully functional VB.NET (.vb) Custom Labels and TickMarks Example for WinForms Solution

Related Documentation Links