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.
PlaceHolder: 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.
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.