Telerik UI for WinForms

Properties

RadMaskedEditBox descends from RadTextBox and so has the same properties, methods and events. The significant properties unique to RadMaskedEditBox are:

  • MaskType: This property determines how masks are interpreted by the control. Valid values are:

    • None - the contol acts like a text box.

    • Numeric - you can define standard numeric masks

    • Standard - you can define standard masks

    • Regex - you can define Regex expressions as masks.

    • IP - predefined mask for IP input.

    • Email - predefined mask for email validation.

  • Mask: A string of characters that constrain user input. The Mask property may contain literals and special mask characters. The MaskType determines how the mask characters are interpreted. Use the backslash "\" character to escape any mask characters so that they display as literals. At runtime, any blank space occupied by a Mask character is displayed as the PromptChar property character.

  • PromptChar: This property represents the character displayed in any blank space defined by a Mask character.  By default the character is an underscore "_".

MaskType and Mask Examples:

MaskType

Mask

User Input

Displayed As/Example

Standard

\# ###

12

# 12_

Standard

###-##-####

1234

123-4_-____

Standard

aaaaa-aaaaa-aaaaa-aaaaa

abc123

abc12-3____-_____-_____

DateTime

d

1 1 2007

01/01/2007

DateTime

MMM dd

Navigate with arrow keys

Dec 1

  • Culture: This property allows you to set the current language and culture from a drop down list at design-time or assign a new CultureInfo instance at run-time.

    editors-maskeditbox-working-with-maskededitbox 001
    Copy[C#]
    this.radMaskedEditBox1.MaskType = Telerik.WinControls.UI.MaskType.DateTime;
    this.radMaskedEditBox1.Mask = "d";
    this.radMaskedEditBox1.Culture = new System.Globalization.CultureInfo("de-de");
    Copy[VB.NET]
    Me.RadMaskedEditBox1.MaskType = Telerik.WinControls.UI.MaskType.DateTime
    Me.RadMaskedEditBox1.Mask = "D"
    Me.RadMaskedEditBox1.Culture = New System.Globalization.CultureInfo("de-DE")
  • Value: This property returns user input without the formatting characters.  If you want the input and the formatting characters, use the Text property. 

  • NullText - determines the text that will be displayed, when the Value of the control is null.

Events

RadMaskedEditBox allows you to handle ValueChanging and ValueChanged events. Examine the Text and Value properties to determine user entry with mask and without mask, respectively. ValueChanging also passes a CancelEventArgs parameter containing a Cancel property. When Cancel is set to true the value is not allowed to change.