New to Telerik UI for WPFStart a free 30-day trial

Represents the RadMaskedNumericInput control.

Definition

Namespace:Telerik.Windows.Controls

Assembly:Telerik.Windows.Controls.Input.dll

Syntax:

C#
[TelerikToolboxCategory("Input")]
[Themable]
public class RadMaskedNumericInput : RadMaskedInputBase

Inheritance: objectRadMaskedInputBaseRadMaskedNumericInput

Inherited Members RadMaskedInputBase.DecimalPointKeyRadMaskedInputBase.DecimalCommaKeyRadMaskedInputBase.NegativeSignKeyRadMaskedInputBase.AddSignKeyRadMaskedInputBase.ValueChangedEventRadMaskedInputBase.ValueChangingEventRadMaskedInputBase.AllowInvalidValuesPropertyRadMaskedInputBase.AcceptsReturnPropertyRadMaskedInputBase.CopyCommandPropertyRadMaskedInputBase.ClearCommandPropertyRadMaskedInputBase.ClearButtonStylePropertyRadMaskedInputBase.CulturePropertyRadMaskedInputBase.CutCommandPropertyRadMaskedInputBase.EmptyContentPropertyRadMaskedInputBase.EmptyContentTemplatePropertyRadMaskedInputBase.ErrorMessagePropertyRadMaskedInputBase.ErrorMessageTemplatePropertyRadMaskedInputBase.FormatStringPropertyRadMaskedInputBase.DisplayErrorMessagePropertyRadMaskedInputBase.InputBehaviorPropertyRadMaskedInputBase.IsClearButtonVisiblePropertyRadMaskedInputBase.IsLastPositionEditablePropertyRadMaskedInputBase.IsReadOnlyPropertyRadMaskedInputBase.IsMaskValidPropertyRadMaskedInputBase.MaskPropertyRadMaskedInputBase.OriginalValuePropertyRadMaskedInputBase.PasteCommandPropertyRadMaskedInputBase.PlaceholderPropertyRadMaskedInputBase.SelectionOnFocusPropertyRadMaskedInputBase.SectionsNavigationModePropertyRadMaskedInputBase.SpinModePropertyRadMaskedInputBase.TextBoxStylePropertyRadMaskedInputBase.TextModePropertyRadMaskedInputBase.UpdateValueEventPropertyRadMaskedInputBase.ValueToTextConverterPropertyRadMaskedInputBase.TextPropertyRadMaskedInputBase.OnApplyTemplate()RadMaskedInputBase.CallSpin(bool)RadMaskedInputBase.SelectAll()RadMaskedInputBase.ResetTheme()RadMaskedInputBase.FindNextAvailablePosition(bool, int)RadMaskedInputBase.MoveCharactersInInsertBehavior(ref int, char, bool)RadMaskedInputBase.ProcessChar(char)RadMaskedInputBase.ReplacePositionWithPlaceholder(int, bool, bool)RadMaskedInputBase.TrimTextStart(string, params char[])RadMaskedInputBase.CopyBinding(Binding)RadMaskedInputBase.OnValueChangedBase(DependencyObject, DependencyPropertyChangedEventArgs, bool)RadMaskedInputBase.CoerceImeInputString(string)RadMaskedInputBase.OnMouseWheel(MouseWheelEventArgs)RadMaskedInputBase.OnCreateAutomationPeer()RadMaskedInputBase.UpdateEditableTextEndPositions()RadMaskedInputBase.UpdateEditableTextEndPositionsOverride(ref int, ref int)RadMaskedInputBase.HandleEnterKey()RadMaskedInputBase.OnApplicationPaste(object, ExecutedRoutedEventArgs)RadMaskedInputBase.OnApplicationCut(object, ExecutedRoutedEventArgs)RadMaskedInputBase.HandlePaste()RadMaskedInputBase.HandleSpaceKey()RadMaskedInputBase.IsMaskValidOverride()RadMaskedInputBase.CheckForDataValidationErrors(DependencyProperty, ref MaskValidationResult)RadMaskedInputBase.IsSeparator(char)RadMaskedInputBase.IsSeparator(char, out Separator)RadMaskedInputBase.IsSeparator(string)RadMaskedInputBase.IsSeparator(string, out Separator)RadMaskedInputBase.IsPlaceholder(char)RadMaskedInputBase.IsPlaceholder(string)RadMaskedInputBase.IsPlaceholder(int)RadMaskedInputBase.StartsWithSeparator(StringBuilder, bool, out Separator)RadMaskedInputBase.StartsWithSeparator(StringBuilder, bool, out Separator, ref int)RadMaskedInputBase.SetSeparators(params Separator[])RadMaskedInputBase.FindNextSeparatorPosition(bool, int, out Separator)RadMaskedInputBase.OnMouseEnter(MouseEventArgs)RadMaskedInputBase.OnMouseLeave(MouseEventArgs)RadMaskedInputBase.SetDefaultStyleKey()RadMaskedInputBase.HandleBackKeyWithMask()RadMaskedInputBase.HandleBackKeyWithMaskSelected()RadMaskedInputBase.OnPreviewKeyDown(KeyEventArgs)RadMaskedInputBase.OnLoadedOverride(object, RoutedEventArgs)RadMaskedInputBase.OnUnloadedOverride(object, RoutedEventArgs)RadMaskedInputBase.HandleDeleteKeyNoMask()RadMaskedInputBase.HandleTabKeyNoMask()RadMaskedInputBase.FindPreviousSeparatorPosition(int)RadMaskedInputBase.FindPreviousAvailablePositionNoMask()RadMaskedInputBase.FindNextSeparatorPosition(int)RadMaskedInputBase.Remove(int, int, bool)RadMaskedInputBase.AllowedNumericTokensRadMaskedInputBase.AllowedDateTimeTokensRadMaskedInputBase.AllowedModifierTokensRadMaskedInputBase.IsUsingOneWayBindingRadMaskedInputBase.IsValueChangingFromInternalRadMaskedInputBase.IsValueInternalSyncRadMaskedInputBase.SeparatorsRadMaskedInputBase.BuilderRadMaskedInputBase.EscapedPositionsRadMaskedInputBase.LiteralPositionsRadMaskedInputBase.MaskResolvedRadMaskedInputBase.MaskedTextResolvedRadMaskedInputBase.EditableTextStartRadMaskedInputBase.EditableTextEndRadMaskedInputBase.EditableTextLengthRadMaskedInputBase.IsRevertingValueRadMaskedInputBase.UseBaseNavigationRadMaskedInputBase.AllowInvalidValuesRadMaskedInputBase.AcceptsReturnRadMaskedInputBase.CopyCommandRadMaskedInputBase.ClearCommandRadMaskedInputBase.ClearButtonStyleRadMaskedInputBase.CultureRadMaskedInputBase.CutCommandRadMaskedInputBase.EmptyContentRadMaskedInputBase.EmptyContentTemplateRadMaskedInputBase.ErrorMessageRadMaskedInputBase.ErrorMessageTemplateRadMaskedInputBase.FormatStringRadMaskedInputBase.DisplayErrorMessageRadMaskedInputBase.InputBehaviorRadMaskedInputBase.IsClearButtonVisibleRadMaskedInputBase.IsLastPositionEditableRadMaskedInputBase.IsReadOnlyRadMaskedInputBase.IsMaskValidRadMaskedInputBase.MaskRadMaskedInputBase.OriginalValueRadMaskedInputBase.PasteCommandRadMaskedInputBase.PlaceholderRadMaskedInputBase.SelectionLengthRadMaskedInputBase.SelectionStartRadMaskedInputBase.SectionsNavigationModeRadMaskedInputBase.SelectionOnFocusRadMaskedInputBase.SpinModeRadMaskedInputBase.TextRadMaskedInputBase.TextBoxStyleRadMaskedInputBase.TextModeRadMaskedInputBase.UpdateValueEventRadMaskedInputBase.ValueToTextConverterRadMaskedInputBase.ValueChangedRadMaskedInputBase.ValueChanging...

Constructors

Initializes a new instance of the RadMaskedNumericInput class.

C#
public RadMaskedNumericInput()

Fields

Identifies the AllowSkipPlaceholders dependency property.

C#
public static readonly DependencyProperty AllowSkipPlaceholdersProperty

Identifies the AutoFillNumberGroupSeparators dependency property.

C#
public static readonly DependencyProperty AutoFillNumberGroupSeparatorsProperty

AutoFillZerosProperty

DependencyProperty

Identifies the AutoFillZeros dependency property.

C#
public static readonly DependencyProperty AutoFillZerosProperty

ValueProperty

DependencyProperty

Identifies the Value dependency property.

C#
public static readonly DependencyProperty ValueProperty

Properties

Gets or sets whether input can skip placeholders.

C#
public bool AllowSkipPlaceholders { get; set; }

Gets or sets whether number group separators are auto filled in the mask.

C#
public bool AutoFillNumberGroupSeparators { get; set; }

Gets or sets whether trailing zeros should be auto filled.

C#
public bool AutoFillZeros { get; set; }

The Decimal separator for the current culture.

C#
protected Separator DecimalSeparator { get; set; }

Gets or sets the resolved InputBehavior.

C#
protected override InputBehavior InputBehaviorResolved { get; }

Overrides: RadMaskedInputBase.InputBehaviorResolved

Gets or sets whether the number is negative. IsNegative returns True for negative nulls too. In no-masked scenarios, "()", "-" are treated as negative nulls.

C#
protected virtual bool IsNegativeValue { get; set; }

Gets or sets whether the number is percentage.

C#
protected bool IsPercentageValue { get; set; }

The Negative symbol for the current culture.

C#
protected Separator NegativeSign { get; set; }

The Number separator for the current culture.

C#
protected Separator NumberSeparator { get; set; }

The Percentage symbol.

C#
protected Separator PercentageSign { get; set; }

The precision of the value.

C#
protected int Precision { get; set; }

Gets or sets the Value property.

C#
public double? Value { get; set; }

Methods

Gets a value indicating whether the char can be modified when no mask.

C#
protected override bool CanModifyChar(char character)
Parameters:charactercharReturns:

bool

Overrides: RadMaskedInputBase.CanModifyChar(char)

Gets a value indicating whether the char can be replaced when no mask.

C#
protected override bool CanReplaceChar(char character)
Parameters:charactercharReturns:

bool

Overrides: RadMaskedInputBase.CanReplaceChar(char)

Clears the selection when no mask.

C#
protected override void ClearSelectionNoMask()

Overrides: RadMaskedInputBase.ClearSelectionNoMask()

The text has changed and the DisplayText has to be coerced against the Text.

C#
protected override string CoerceDisplayTextOverride()
Returns:

string

Returns the display text.

Overrides: RadMaskedInputBase.CoerceDisplayTextOverride()

Coerces the ValueInternal property from the Value property.

C#
protected override void CoerceInternalValueFromStronglyTypeValueOverride()

Overrides: RadMaskedInputBase.CoerceInternalValueFromStronglyTypeValueOverride()

Coerces the Value property from the ValueInternal property.

C#
protected override void CoerceStronglyTypeValueFromInternalValueOverride()

Overrides: RadMaskedInputBase.CoerceStronglyTypeValueFromInternalValueOverride()

The internal value has changed and the Text has to be coerced against the ValueInternal.

C#
protected override string CoerceTextInternalOverride(ref int selectionStart)
Parameters:selectionStartintReturns:

string

Returns the string coerced from ValueInternal.

Overrides: RadMaskedInputBase.CoerceTextInternalOverride(ref int)

The value has changed and the Text has to be coerced against the value.

C#
protected override string CoerceTextOverride(ref int selectionStart)
Parameters:selectionStartintReturns:

string

Returns the string to be coerced.

Overrides: RadMaskedInputBase.CoerceTextOverride(ref int)

The text has changed and the value has to be coerced against the text.

C#
protected override bool CoerceValueOverride()
Returns:

bool

Returns true if the value can be coerced.

Overrides: RadMaskedInputBase.CoerceValueOverride()

Gets the index of the decimal separator from a specific text.

C#
protected int GetDecimalSeparatorIndex(string text)
Parameters:textstring

The text to search in.

Returns:

int

Returns the index of the Decimal separator.

Gets the offset from the right.

C#
protected override int GetRightOffset()
Returns:

int

Overrides: RadMaskedInputBase.GetRightOffset()

Gets the valid char for a position.

C#
protected override string GetValidCharOverride(char character, ref int position, bool? forwardSpin, out bool isValid)
Parameters:characterchar

The character to be validated.

positionint

Position in the MaskedText to validate.

forwardSpinbool?

True if a forward spin is applied, false for backward spin, null for no spin.

isValidbool

True if the character is valid for this position.

Returns:

string

Returns the result valid character for the specified position.

Overrides: RadMaskedInputBase.GetValidCharOverride(char, ref int, bool?, out bool)

Gets the rank of a number in the TextBox in respect to the caret.

C#
protected int GetValueRankFromIndex(int index)
Parameters:indexint

The index of the caret.

Returns:

int

Returns the rank.

Handles the Back key when no mask.

C#
protected override void HandleBackKeyNoMask()

Overrides: RadMaskedInputBase.HandleBackKeyNoMask()

Called, when the Clear command is invoked.

C#
protected override void HandleClearOverride()

Overrides: RadMaskedInputBase.HandleClearOverride()

Handles the Divide key.

C#
protected override bool HandleDivideKey()
Returns:

bool

Returns a value indicating whether event should be handled or not.

Overrides: RadMaskedInputBase.HandleDivideKey()

Handles the left key down.

C#
protected override void HandleLeftKey()

Overrides: RadMaskedInputBase.HandleLeftKey()

Handles the Multiply key.

C#
protected override bool HandleMultiplyKey()
Returns:

bool

Returns a value indicating whether event should be handled or not.

Overrides: RadMaskedInputBase.HandleMultiplyKey()

Handles paste operation in no-mask scenarios.

C#
protected override bool HandlePasteNoMask(object value, out object returnString)
Parameters:valueobjectreturnStringobjectReturns:

bool

Overrides: RadMaskedInputBase.HandlePasteNoMask(object, out object)

Handles the paste operation.

C#
protected override bool HandlePasteOverride(object value, out object returnString)
Parameters:valueobject

The value to be pasted.

returnStringobject

Returns the string representation of the value.

Returns:

bool

Returns true if the value can be pasted.

Overrides: RadMaskedInputBase.HandlePasteOverride(object, out object)

Handle the spin of the value.

C#
protected override void HandleSpin(int position, bool? forwardSpin)
Parameters:positionint

Position of spin.

forwardSpinbool?

Direction of spin.

Overrides: RadMaskedInputBase.HandleSpin(int, bool?)

Handles the spin when no mask.

C#
protected override void HandleSpinNoMask(bool isUp)
Parameters:isUpbool

Overrides: RadMaskedInputBase.HandleSpinNoMask(bool)

Handles the Subtract key.

C#
protected override bool HandleSubstractKey()
Returns:

bool

Returns a value indicating whether event should be handled or not.

Overrides: RadMaskedInputBase.HandleSubstractKey()

Handles the key press of an Unknown key with a specific key code.

C#
protected override bool HandleUnknownKeyOverride(int keyCode)
Parameters:keyCodeint

Key's key code.

Returns:

bool

Returns true if the key should not be processed.

Overrides: RadMaskedInputBase.HandleUnknownKeyOverride(int)

Inserts a new character when no mask.

C#
protected override void InsertCharNoMask(char character)
Parameters:characterchar

Overrides: RadMaskedInputBase.InsertCharNoMask(char)

Inserts number group separators in the mask.

C#
protected static string InsertSeparatorsOverride(string mask, int[] groupSizes, string groupSeparator)
Parameters:maskstring

The mask text.

groupSizesint[]

The group sizes.

groupSeparatorstring

The group separator.

Returns:

string

Returns the modified string.

Gets a value indicating whether the char is valid when no mask.

C#
protected override bool IsCharValid(char character)
Parameters:charactercharReturns:

bool

Overrides: RadMaskedInputBase.IsCharValid(char)

Gets a value indicating whether a char is a separator when no mask.

C#
protected override bool IsSeparatorNoMask(char character)
Parameters:charactercharReturns:

bool

Overrides: RadMaskedInputBase.IsSeparatorNoMask(char)

Moves a group characters from the specified position to the left one position from the last Placeholder.

C#
protected override void MoveCharactersInInsertBehaviorOverride(ref int position, char character, bool forward)
Parameters:positionint

The position from which the move has to be done.

characterchar

The character input at this position.

forwardbool

The direction of the moving.

Overrides: RadMaskedInputBase.MoveCharactersInInsertBehaviorOverride(ref int, char, bool)

Remarks:

The method expects the text after the move to the set to the internal TextBox.

Executed when the Culture changes.

C#
protected override void OnCultureChanged()

Overrides: RadMaskedInputBase.OnCultureChanged()

Raises the event. This method is invoked whenever is set to true internally.

C#
protected override void OnInitialized(EventArgs e)
Parameters:eEventArgs

The RoutedEventArgs that contains the event data.

Executes when the focus is obtained.

C#
protected override int OnSelectionOnFocus(SelectionOnFocus selectionOnFocus)
Parameters:selectionOnFocusSelectionOnFocus

The selection on focus.

Returns:

int

Returns the selection start to be set when the focus is obtained.

Overrides: RadMaskedInputBase.OnSelectionOnFocus(SelectionOnFocus)

Parses the Mask property and sets the MaskedText.

C#
protected override string ParseMask()
Returns:

string

Returns the parsed Mask.

Overrides: RadMaskedInputBase.ParseMask()

Replaces a char when no mask.

C#
protected override void ReplaceChar(StringBuilder text, ref int position)
Parameters:textStringBuilder

The text builder.

positionint

The position of the char.

Overrides: RadMaskedInputBase.ReplaceChar(StringBuilder, ref int)

Sets the offset from the right.

C#
protected override void SetFromRightOffset(int offset)
Parameters:offsetint

Overrides: RadMaskedInputBase.SetFromRightOffset(int)

Toggles the visibility of the Negative symbol.

C#
protected void ToggleNegativeSignKey()

Performs a pre-value changing checking whether the inherited control allows the ValueChanging(ed) events to be raised.

C#
protected override bool ValueChangingOverride(RoutedEventArgs args)
Parameters:argsRoutedEventArgsReturns:

bool

Returns a boolean flag whether the value change has to be handled or not.

Overrides: RadMaskedInputBase.ValueChangingOverride(RoutedEventArgs)

Remarks:

If false is returns, the value change proceeds. If true is returned, the update is terminated.