TextEditor Constructor(String)

Initializes a new instance of the TextEditor class specifying the string to use as a mask.

Syntax

Visual Basic
C#

'Declaration
 
Public Function New( _

   ByVal mask As String _

)

'Usage
 
Dim mask As String

 

Dim instance As New TextEditor(mask)

public TextEditor( 

   string mask

)

Parameters

mask: A string representing the control's mask.

Remarks

The mask passed as a parameter will be assigned to the TemplateControl's Xceed.Editors.TextBoxArea's Xceed.Editors.TextBoxArea.Mask property.

The casing characters (< and >) only affect the characters entered by keyboard when they are the first characters of the mask. Casing characters located anywhere else are considered to be literals.

By default, the following mask characters are supported:

#	Digits or white space
9	Digits only
A	Alpha-numeric values only
a	Alpha-numeric values or white space
@	Letters only
&	Any printable character (ascii characters from 32 to 126 and 128 to 255)

The following table provides a list of characters which are not mask characters but still affect the formatting of the text:

>	When used as the first character of a mask, it converts all inputted characters to uppercase. When used elsewhere within the mask, it is considered as a literal.
<	When used as the first character of a mask, it converts all inputted characters to lowercase. When used elsewhere within the mask, it is considered as a literal.
\	The character following this character will always be considered as a literal. For example, \9 will be the 9 literal instead of the digits mask character.

All other characters are considered as literals.

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

TextEditor Class
TextEditor Members
Overload List