Name

NumericUpDown

Synopsis

This control combines a TextBox with an up-down button to select a number. If the ReadOnly property is set to true, you can only alter the number with the up-down buttons, but otherwise you can also type into the text box. If the user does type into the box, the ValidateEditText() method will be called, and the UserEdit property is set to true. Subsequent typing causes the UpdateEditText() method to be called, as for all controls derived from UpDownBase. You can override these methods in a derived class to validate user input.

You can specify the Value displayed in the box, in addition to a Text representation of that number. The number may also be displayed with a ThousandsSeparator (the character for which is determined by the Culture settings currently in operation), and you can select the number of DecimalPlaces to show. Alternatively, you can choose a Hexadecimal representation.

Finally, the range of the control is limited by the Minimum and Maximum properties, and the value that will be added or removed as the buttons are clicked is defined by the Increment property.


public class NumericUpDown : UpDownBase : System.ComponentModel.ISupportInitialize {

// Public Constructors

   public NumericUpDown();

// Public Instance Properties

   public int DecimalPlaces{set; get; }

   public bool Hexadecimal{set; get; }

   public decimal Increment{set; get; }

   public decimal Maximum{set; get; }

   public decimal Minimum{set; get; }

   public override string Text{set; get; }

// overrides ...

Get .NET Windows Forms in a Nutshell now with the O’Reilly learning platform.

O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.