IntegerUpDown
The IntegerUpDown control provides a TextBox with button spinners that allow incrementing and decrementing Nullable<int> values by using the spinner buttons, keyboard up/down arrows, or mouse wheel.Usage
When using the IntegerUpDown in data binding scenarios, bind your object's value to the Value property. You can specify how much to increment the value by setting the Increment property. You can control the minimum and maximum allowed values by setting the Minimum and the Maximum properties. If you would like to get the actual formatted string representation of the value, you can use the Text property.
Applying FormatStrings
Default:<xctk:IntegerUpDown Value="1564" />
Number:
<xctk:IntegerUpDown FormatString="N0" Value="1564" Increment="1" Maximum="200000"/>
Currency:
<xctk:IntegerUpDown FormatString="C0" Value="1564" Increment="1" Maximum="5000" Minimum="50"/>
Supported Format Strings
Format Specifier | Name |
---|---|
C | Currency |
F | Fixed Point |
G | General |
N | Number |
P | Percent |
Watermark
You can provide a Watermark to show text in place of a NULL Value.<xctk:IntegerUpDown Watermark="Enter Integer" />
Properties / Events
Property | Description |
---|---|
AllowSpin | Gets/Sets the ability to perform increment/decrement operations via the keyboard, button spinners, or mouse wheel. |
CultureInfo | Gets/Sets the current CultureInfo. |
DefaultValue | Get/Sets the value to use when the Value is null and an increment/decrement operation is performed. |
FormatString | Gets/Sets the dispaly format of the Value. |
Increment | Specifies the amount in which to increment the value. |
IsReadOnly | Gets/Sets a value indicating whether the control is read only. |
Maximum | Gets/Sets the maximum allowed value. |
Mimum | Gets/Sets the minimum allowed value. |
MouseWheelActiveOnFocus | Gets/Sets if the control must have focus in order for the mouse wheel to incement/decrement the value. True by default. |
SelectAllOnGotFocus | If set to true, all text is selected when control gets focus. |
ShowButtonSpinner | Gets/Sets if the button spinners are visible. |
Text | Gets/Sets the formated string representation of the value. |
TextAlignment | Gets/Sets the alignment of the Text. |
Value | Gets/Sets the numeric value. |
Watermark | Gets/Sets the object to use as a watermark if the Value is null. |
WatermarkTemplate | Gets/Sets the DatTemplate to use for the Watermark. |
Event | Description |
---|---|
ValueChanged | Occurs when the Value changes. |