Range Scroll Bars Example for WinForms

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

Range Scroll Bars Example for WinForms Description

This example demonstrates how to create and use range scroll bars. Range scroll bars are range based widgets, which are used for selecting a range defined by a begin and an end value. They can be horizontal and vertical and expose a set of properties, which you can use to control their appearance and behavior.


Range Scroll Bars Example

C# Range Scroll Bars Example Code for Nevron UserInterface for WinForms
Language: C#

using Nevron.Nov;
using Nevron.Nov.DataStructures;
using Nevron.Nov.Dom;
using Nevron.Nov.Editors;
using Nevron.Nov.Graphics;
using Nevron.Nov.Layout;
using Nevron.Nov.Presentation;
using Nevron.Nov.UI;
using Nevron.Nov.Windows.Forms;
using System.Windows.Forms;

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

		public Form1()
		{
			InitializeComponent();

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

			// 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()
		{
			// Create a stack for the scroll bars
			NStackPanel stack = new NStackPanel();
			stack.FillMode = ENStackFillMode.Last;
			stack.FitMode = ENStackFitMode.Last;
			
			// Create the HScrollBar
			m_HScrollBar = new NHRangeScrollBar();
			m_HScrollBar.BeginValue = 20;
			m_HScrollBar.EndValue = 40;
			m_HScrollBar.VerticalPlacement = ENVerticalPlacement.Top;
			m_HScrollBar.BeginValueChanged += OnScrollBarValueChanged;
			m_HScrollBar.EndValueChanged += OnScrollBarValueChanged;
			stack.Add(new NGroupBox("Horizontal", m_HScrollBar));

			// Create the VScrollBar
			m_VScrollBar = new NVRangeScrollBar();
			m_VScrollBar.BeginValue = 20;
			m_VScrollBar.EndValue = 40;
			m_VScrollBar.HorizontalPlacement = ENHorizontalPlacement.Left;
			m_VScrollBar.BeginValueChanged += OnScrollBarValueChanged;
			m_VScrollBar.EndValueChanged += OnScrollBarValueChanged;
			stack.Add(new NGroupBox("Vertical", m_VScrollBar));

			return stack;
		}
		public NWidget CreateExampleControls()
		{
			NStackPanel stack = new NStackPanel();
			stack.FillMode = ENStackFillMode.Last;
			stack.FitMode = ENStackFitMode.Last;

			// Create a tab
			NTab tab = new NTab();
			stack.Add(tab);

			// Create the Horizontal scrollbar properties
			NStackPanel hsbStack = new NStackPanel();
			NList editors = NDesigner.GetDesigner(m_HScrollBar).CreateMemberEditors(
				m_HScrollBar,
				NHRangeScrollBar.EnabledProperty,
				NHRangeScrollBar.BeginValueProperty,
				NHRangeScrollBar.EndValueProperty,
				NHRangeScrollBar.SmallChangeProperty,
				NHRangeScrollBar.SnappingStepProperty,
				NHRangeScrollBar.MinimumProperty,
				NHRangeScrollBar.MaximumProperty);
			
			for (int i = 0; i < editors.Count; i++)
			{
				hsbStack.Add(editors[i]);
			}

			tab.TabPages.Add(new NTabPage("Horizontal", hsbStack));

			// Create the Vertical scrollbar properties
			NStackPanel vsbStack = new NStackPanel();
			editors = NDesigner.GetDesigner(m_VScrollBar).CreateMemberEditors(
				m_VScrollBar,
				NVRangeScrollBar.EnabledProperty,
				NVRangeScrollBar.BeginValueProperty,
				NVRangeScrollBar.EndValueProperty,
				NVRangeScrollBar.SmallChangeProperty,
				NVRangeScrollBar.SnappingStepProperty,
				NVRangeScrollBar.MinimumProperty,
				NVRangeScrollBar.MaximumProperty
			);

			for (int i = 0; i < editors.Count; i++)
			{
				vsbStack.Add(editors[i]);
			}

			tab.TabPages.Add(new NTabPage("Vertical", vsbStack));

			// Add events log
			m_EventsLog = new NExampleEventsLog();
			stack.Add(m_EventsLog);

			return new NUniSizeBoxGroup(stack);
		}
		public string GetExampleDescription()
		{
			return @"

This example demonstrates how to create and use range scroll bars. Range scroll bars are range based widgets, which are used for selecting a range defined by a begin and an end value. They can be horizontal and vertical and expose a set of properties, which you can use to control their appearance and behavior.

"; } /// /// Gets the relevant documentation links for the example /// /// public (string Name, string Url)[] GetDocumentationUrls() { return new[] { ("Scrollbars", "https://www.nevron.com/docs/openvision/ui-scrollbars.html"), ("Range Based Widgets Overview", "https://www.nevron.com/docs/openvision/ui-range-based-widgets-overview.html"), }; } #endregion #region Implementation #endregion #region Event Handlers private void OnScrollBarValueChanged(NValueChangeEventArgs args) { string text; if (args.TargetNode == m_HScrollBar) { text = "Horizontal Range: " + m_HScrollBar.BeginValue.ToString("0.###") + " - " + m_HScrollBar.EndValue.ToString("0.###"); } else { text = "Vertical Range: " + m_VScrollBar.BeginValue.ToString("0.###") + " - " + m_VScrollBar.EndValue.ToString("0.###"); ; } m_EventsLog.LogEvent(text); } #endregion #region Fields private NExampleEventsLog m_EventsLog; private NHRangeScrollBar m_HScrollBar; private NVRangeScrollBar m_VScrollBar; #endregion #region Static Methods #endregion #region Constants #endregion #region Nested Types #endregion } }

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

VB.NET Range Scroll Bars Example Code for Nevron UserInterface for WinForms
Language: VB.NET

Imports Nevron.Nov
Imports Nevron.Nov.Dom
Imports Nevron.Nov.Editors
Imports Nevron.Nov.Graphics
Imports Nevron.Nov.Layout
Imports Nevron.Nov.UI
Imports Nevron.Nov.Windows.Forms

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 - NRangeScrollBarsExample"

        ' 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
            ' Create a stack for the scroll bars
            Dim stack As NStackPanel = New NStackPanel()
            stack.FillMode = ENStackFillMode.Last
            stack.FitMode = ENStackFitMode.Last

            ' Create the HScrollBar
            m_HScrollBar = New NHRangeScrollBar()
            m_HScrollBar.BeginValue = 20
            m_HScrollBar.EndValue = 40
            m_HScrollBar.VerticalPlacement = ENVerticalPlacement.Top
            Me.m_HScrollBar.BeginValueChanged += AddressOf OnScrollBarValueChanged
            Me.m_HScrollBar.EndValueChanged += AddressOf OnScrollBarValueChanged
            stack.Add(New NGroupBox("Horizontal", m_HScrollBar))

            ' Create the VScrollBar
            m_VScrollBar = New NVRangeScrollBar()
            m_VScrollBar.BeginValue = 20
            m_VScrollBar.EndValue = 40
            m_VScrollBar.HorizontalPlacement = ENHorizontalPlacement.Left
            Me.m_VScrollBar.BeginValueChanged += AddressOf OnScrollBarValueChanged
            Me.m_VScrollBar.EndValueChanged += AddressOf OnScrollBarValueChanged
            stack.Add(New NGroupBox("Vertical", m_VScrollBar))

            Return stack
        End Function
        Public Function CreateExampleControls() As NWidget
            Dim stack As NStackPanel = New NStackPanel()
            stack.FillMode = ENStackFillMode.Last
            stack.FitMode = ENStackFitMode.Last

            ' Create a tab
            Dim tab As NTab = New NTab()
            stack.Add(tab)

            ' Create the Horizontal scrollbar properties
            Dim hsbStack As NStackPanel = New NStackPanel()
            Dim editors = NDesigner.GetDesigner(m_HScrollBar).CreateMemberEditors(m_HScrollBar, NInputElement.EnabledProperty, NHRangeScrollBar.BeginValueProperty, NHRangeScrollBar.EndValueProperty, NHRangeScrollBar.SmallChangeProperty, NHRangeScrollBar.SnappingStepProperty, NRangeBase.MinimumProperty, NRangeBase.MaximumProperty)

            For i = 0 To editors.Count - 1
                hsbStack.Add(editors(i))
            Next

            tab.TabPages.Add(New NTabPage("Horizontal", hsbStack))

            ' Create the Vertical scrollbar properties
            Dim vsbStack As NStackPanel = New NStackPanel()
            editors = NDesigner.GetDesigner(m_VScrollBar).CreateMemberEditors(m_VScrollBar, NInputElement.EnabledProperty, NVRangeScrollBar.BeginValueProperty, NVRangeScrollBar.EndValueProperty, NVRangeScrollBar.SmallChangeProperty, NVRangeScrollBar.SnappingStepProperty, NRangeBase.MinimumProperty, NRangeBase.MaximumProperty)

            For i = 0 To editors.Count - 1
                vsbStack.Add(editors(i))
            Next

            tab.TabPages.Add(New NTabPage("Vertical", vsbStack))

            ' Add events log
            m_EventsLog = New NExampleEventsLog()
            stack.Add(m_EventsLog)

            Return New NUniSizeBoxGroup(stack)
        End Function
        Public Function GetExampleDescription() As String
            Return "

This example demonstrates how to create and use range scroll bars. Range scroll bars are range based widgets, which are used for selecting a range defined by a begin and an end value. They can be horizontal and vertical and expose a set of properties, which you can use to control their appearance and behavior.

" End Function ''' ''' Gets the relevant documentation links for the example ''' ''' Public Function GetDocumentationUrls() As (String, String)() Return {("Scrollbars", "https://www.nevron.com/docs/openvision/ui-scrollbars.html"), ("Range Based Widgets Overview", "https://www.nevron.com/docs/openvision/ui-range-based-widgets-overview.html")} End Function #End Region #Region "Implementation" #End Region #Region "Event Handlers" Private Sub OnScrollBarValueChanged(args As NValueChangeEventArgs) Dim text As String If args.TargetNode Is m_HScrollBar Then text = "Horizontal Range: " & m_HScrollBar.BeginValue.ToString("0.###") & " - " & m_HScrollBar.EndValue.ToString("0.###") Else text = "Vertical Range: " & m_VScrollBar.BeginValue.ToString("0.###") & " - " & m_VScrollBar.EndValue.ToString("0.###") End If m_EventsLog.LogEvent(text) End Sub #End Region #Region "Fields" Private m_EventsLog As NExampleEventsLog Private m_HScrollBar As NHRangeScrollBar Private m_VScrollBar As NVRangeScrollBar #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) Range Scroll Bars Example for WinForms Solution

Related Documentation Links