C# | NumericUpDown Class

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:

    filter_none

    edit
    close

    play_arrow

    link
    brightness_4
    code

    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);
        }
    }
    }

    chevron_right

    
    

    Output:

Constructor

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

Properties

Property Description
AutoSize This property is used to get or set a value that indicates whether the control resizes based on its contents.
BackColor This property is used to get or set the background color for the control.
BorderStyle This property indicates the border style for the control.
Font This property is used to get or set the font of the text displayed by the control.
ForeColor This property is used to get or set the foreground color of the control.
Height This property is used to get or set the height of the control.
Location This 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.
Name This property is used to get or set the name of the control.
TabStop This 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.
Size This property is used to get or set the height and width of the control.
Text This property is used to get or set the text to be displayed in the NumericUpDown control.
TextAlign This property is used to get or set the alignment of the text in the spin box (also known as an up-down control).
Visible This property is used to get or set a value indicating whether the control and all its child controls are displayed.
Width This property is used to get or set the width of the control.
UpDownAlign This 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).
ThousandsSeparator This 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.
Hexadecimal This 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.
Increment This 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

Check out this Author's contributed articles.

If you like GeeksforGeeks and would like to contribute, you can also write an article using contribute.geeksforgeeks.org or mail your article to contribute@geeksforgeeks.org. See your article appearing on the GeeksforGeeks main page and help other Geeks.

Please Improve this article if you find anything incorrect by clicking on the "Improve Article" button below.




Article Tags :

Be the First to upvote.


Please write to us at contribute@geeksforgeeks.org to report any issue with the above content.