xmlns:ig="http://schemas.infragistics.com/xaml"
We recommend that you use the xamNumericEditor control instead of the xamNumericInput control. The xamNumericInput is being planned for retirement over the next few years and will not receive any new features. We will continue to provide support and critical bug fixes for the xamNumericInput during this time. For help or questions on migrating your codebase to the xamNumericEditor, please contact support.
This topic demonstrates how to add a xamNumericInput™ control to your application and use some of its more notable properties.
You need to first read the following topics:
The table below lists some of the configurable behaviors of the xamNumericInput control.
Add the Infragistics namespace.
Add the references needed.
In order to add a xamNumericInput to your application, you must add the following NuGet package reference to your project:
Infragistics.WPF.Controls.Editors.XamMaskedInput
For more information on setting up the NuGet feed and adding NuGet packages, you can take a look at the following documentation: NuGet Feeds.
Add the Infragistics namespace
In XAML:
xmlns:ig="http://schemas.infragistics.com/xaml"In Visual Basic:
Imports Infragistics.Controls.EditorsIn C#:
using Infragistics.Controls.Editors;Add a xamNumericInput control.
In XAML:
<ig:XamNumericInput/>In Visual Basic:
Dim input As XamNumericInput = New XamNumericInput()In C#:
XamNumericInput NumericInput = new XamNumericInput();The table below maps the desired configurations to property settings. The properties are directly accessed from the xamNumericInput control.
Set a Mask.
The most important part of setting up an input control is configuring the Mask property. Set a mask that suits your needs by:
In XAML:
<ig:XamNumericInput Mask=”[Your Mask]”/>In Visual Basic:
NumericInput.Mask = ”[Your Mask]”In C#:
NumericInput.Mask = ”[Your Mask]”;For more information on how to create a mask, please refer to the Masks Topic.
Revert the entered value, when it is invalid.
There are several options for how the xamNumericInput behaves when invalid value is entered by the user. If you set the InvalidValueBehavior property to RevertValue, every time the user enters an invalid value and leaves the input control, the new value is reverted to the original value.
Let the user copy the contents of the control including all additional symbols.
Setting the ClipMode property to IncludeBoth copies the input control’s contents to the clipboard including all prompt characters and mask literals.
Display a specific string when the value is null.
When no value is entered in the control or when it is bound to a null value, you can set a string that is displayed. You can do this by setting the NullText property to the desired string. In this way you can guide the user on what to enter or to explicitly indicate that no value has been entered.
Display different prompt character than underscore.
The default prompt character used in the xamNumericInput is an underscore, but you can change this behavior by setting the PromptChar property to a character of your own choosing.
Display buttons for incrementing/decrementing the value.
If you want to display buttons for incrementing or decrementing the value of the xamNumericInput control you need to set the SpinButtonDisplayMode to Always, Focused, or MouseOver.
Change the increment value.
If you don’t specify the SpinIncrement property the default increment/decrement value used when the SpinButtons are clicked will be 1. However you may want it to be something else and you can do this by setting the desired value as the SpinIncrement.
Set the input to keep fractional zeros that are in the end of the value.
If you want zeros in the end of the fractional place of the xamNumericInput controls’s value to display you can set the TrimFractionalZeros property to False.
Enable/disable undo/redo operations.
By default, the xamInputs support undo/redo operations triggered by CTRL+Z and CTRL + Y keys combinations. If you want to disable this functionality, you can set the IsUndoEnabled property to False.
The images below demonstrate a xamNumericInput control in edit and display mode as a result of the following settings:
For detailed information about these properties, refer to their listing in the property reference section:
Following are some other topics you may find useful.
