# NumericUpDown

A Wisej.NET `NumericUpDown` control contains a single numeric value that can be incremented or decremented using the up or down buttons. Users can enter values directly unless the `ReadOnly` property is set to `true`.

Format the numeric display using the `DecimalPlaces`, `Hexadecimal`, or `ThousandsSeparator` properties. Set `Hexadecimal` to `true` to display hexadecimal values. Enable `ThousandsSeparator` to display the thousands separator in decimal numbers. Set `DecimalPlaces` to specify the number of digits after the decimal symbol.

{% hint style="info" %}
For a full list of properties, methods and events see the [API documentation.](http://docs.wisej.com/api)
{% endhint %}

## Features

### Label

The `NumericUpDown` control supports the inline [Label](https://docs.wisej.com/docs/controls/general/labels) property. This allows setting a label in relation to a `NumericUpDown` control without creating an additional `Label` control.

![NumericUpDown control with label](https://553579532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MF1D11gPs_az3xaKusw%2Fuploads%2Fgit-blob-293c2e4580c848fac361b5be20ac81256810ecfa%2Fimage.png?alt=media)

{% content-ref url="../general/labels" %}
[labels](https://docs.wisej.com/docs/controls/general/labels)
{% endcontent-ref %}

### Formatting

The `NumericUpDown` control offers several formatting properties. The `Prefix` property prepends a character or string to the value. The `Postfix` property appends a character or string to the value. Enable the `ThousandsSeparator` property to display commas for values exceeding three digits.

![NumericUpDown with formatting options](https://553579532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MF1D11gPs_az3xaKusw%2Fuploads%2Fgit-blob-352d1e00517ee509ff2f6d90f64d80f77782c8c8%2Fimage.png?alt=media)

## Advanced

### JavaScript Widget

| Item             | Description                                                                                                         |
| ---------------- | ------------------------------------------------------------------------------------------------------------------- |
| Class name       | "wisej.web.NumericUpDown"                                                                                           |
| Theme appearance | "spinner", see [Themes](https://docs.wisej.com/theme-builder/theme-elements/elements).                              |
| Child components | "upbutton" is the up button. "downbutton" is the down button. "textfield" is the textfield.                         |
| Source code      | [https://github.com/iceteagroup/wisej-js](https://github.com/iceteagroup/wisej-js/blob/master/wisej.web.TextBox.js) |