Represents a spinner control that displays numeric values.

A NumericUpDown control contains a single numeric value that can be incremented or decremented by clicking the up or down buttons of the control. The user can also enter in a value, unless the ReadOnly property is set to true.

The numeric display can be formatted by setting the DecimalPlaces, Hexadecimal, or ThousandsSeparator properties. To display hexadecimal values in the control, set the Hexadecimal property to true. To display a thousands separator in decimal numbers when appropriate, set the ThousandsSeparator property to true. To specify the number of digits displayed after the decimal symbol, set the DecimalPlaces property to the number of decimal places to display.

For a full list of properties, methods and events see the API documentation.



The NumericUpDown control supports the inline Label property. This allows an application to set a label in relation to a NumericUpDown control without having to create an additional Label control.



The NumericUpDown control features several properties to enhance formatting. The Prefix property specifies a character or string that will be prepended to the value. The Postfix property specifies a character or string that will be appended to the value. Formatting can also be applied to show commas when the value exceeds three digits using the ThousandsSeparator property.


JavaScript Widget


Class name


Theme appearance

"spinner", see Themes.

Child components

"upbutton" is the up button. "downbutton" is the down button. "textfield" is the textfield.

Source code

Last updated