Skip to content
Related Articles

Related Articles

Improve Article

C# | NumericUpDown Class

  • Last Updated : 05 Sep, 2019

In Windows Forms, NumericUpDown control is used to provide a Windows spin box or an up-down control which displays the numeric values. Or in other words, NumericUpDown control provides an interface which moves using up and down arrow and holds some pre-defined numeric value. The NumericUpDown class is used to represent the windows numeric up-down box and also provide different types of properties, methods, and events. It is defined under System.Windows.Forms namespace. In C# you can create a NumericUpDown in the windows form by using two different ways:

1. Design-Time: It is the easiest way to create a NumericUpDown as shown in the following steps:

  • Step 1: Create a windows form as shown in the below image:
    Visual Studio -> File -> New -> Project -> WindowsFormApp
  • Step 2: Next, drag and drop the NumericUpDown control from the toolbox to the form.

  • Step 3: After drag and drop you will go to the properties of the NumericUpDown control to modify NumericUpDown according to your requirement.

    Output:

2. Run-Time: It is a little bit trickier than the above method. In this method, you can create a NumericUpDown control programmatically with the help of syntax provided by the NumericUpDown class. The following steps show how to set the create NumericUpDown dynamically:

  • Step 1: Create a NumericUpDown control using the NumericUpDown() constructor is provided by the NumericUpDown class.
    // Creating a NumericUpDown control
    NumericUpDown nbox = new NumericUpDown(); 
    
  • Step 2: After creating a NumericUpDown control, set the property of the NumericUpDown control provided by the NumericUpDown class.
    // Setting the properties of NumericUpDown control
    nbox.Location = new Point(386, 130); 
    nbox.Size = new Size(126, 26); 
    nbox.Font = new Font("Bodoni MT", 12); 
    nbox.Value = 18; 
    nbox.Minimum = 18; 
    nbox.Maximum = 30; 
    nbox.BackColor = Color.LightGreen; 
    nbox.ForeColor = Color.DarkGreen; 
    nbox.Increment = 1; 
    nbox.Name = "MySpinBox"; 
    
  • Step 3: And last add this NumericUpDown control to the form using the following statement:
    // Adding this control 
    // to the form 
    this.Controls.Add(nbox); 
    

    Example:




    using System;
    using System.Collections.Generic;
    using System.ComponentModel;
    using System.Data;
    using System.Drawing;
    using System.Linq;
    using System.Text;
    using System.Threading.Tasks;
    using System.Windows.Forms;
      
    namespace WindowsFormsApp42 {
      
    public partial class Form1 : Form {
      
        public Form1()
        {
            InitializeComponent();
        }
      
        private void Form1_Load(object sender, EventArgs e)
        {
            // Creating and setting the
            // properties of the labels
            Label l1 = new Label();
            l1.Location = new Point(348, 61);
            l1.Size = new Size(215, 20);
            l1.Text = "Form";
            l1.Font = new Font("Bodoni MT", 12);
            this.Controls.Add(l1);
      
            Label l2 = new Label();
            l2.Location = new Point(242, 136);
            l2.Size = new Size(103, 20);
            l2.Text = "Enter Age";
            l2.Font = new Font("Bodoni MT", 12);
            this.Controls.Add(l2);
      
            // Creating and setting the
            // properties of NumericUpDown
            NumericUpDown nbox = new NumericUpDown();
            nbox.Location = new Point(386, 130);
            nbox.Size = new Size(126, 26);
            nbox.Font = new Font("Bodoni MT", 12);
            nbox.Value = 18;
            nbox.Minimum = 18;
            nbox.Maximum = 30;
            nbox.BackColor = Color.LightGreen;
            nbox.ForeColor = Color.DarkGreen;
            nbox.Increment = 1;
            nbox.Name = "MySpinBox";
      
            // Adding this control
            // to the form
            this.Controls.Add(nbox);
        }
    }
    }

    Output:

Constructor

ConstructorDescription
NumericUpDown()This Constructors is used to initialize a new instance of the NumericUpDown class.

Properties

PropertyDescription
AutoSizeThis property is used to get or set a value that indicates whether the control resizes based on its contents.
BackColorThis property is used to get or set the background color for the control.
BorderStyleThis property indicates the border style for the control.
FontThis property is used to get or set the font of the text displayed by the control.
ForeColorThis property is used to get or set the foreground color of the control.
HeightThis property is used to get or set the height of the control.
LocationThis property is used to get or set the coordinates of the upper-left corner of the NumericUpDown control relative to the upper-left corner of its form.
NameThis property is used to get or set the name of the control.
TabStopThis property is used to get or set a value that shows whether the user can press the TAB key to provide the focus to the NumericUpDown.
SizeThis property is used to get or set the height and width of the control.
TextThis property is used to get or set the text to be displayed in the NumericUpDown control.
TextAlignThis property is used to get or set the alignment of the text in the spin box (also known as an up-down control).
VisibleThis property is used to get or set a value indicating whether the control and all its child controls are displayed.
WidthThis property is used to get or set the width of the control.
UpDownAlignThis property is used to get or set the alignment of the up and down buttons on the spin box (also known as an up-down control).
ThousandsSeparatorThis property is used to get or set a value indicating whether a thousands separator is displayed in the spin box (also known as an up-down control) when appropriate.
HexadecimalThis property is used to get or set a value indicating whether the spin box (also known as an up-down control) should display the value it contains in hexadecimal format.
IncrementThis property is used to get or set the value to increment or decrement the spin box (also known as an up-down control) when the up or down buttons are clicked.



My Personal Notes arrow_drop_up
Recommended Articles
Page :