MaskedEditBox Masks

Determines the input mask for the control.

The control can distinguish between numeric and alphabetic characters for validation, but cannot check for valid content, such as the correct month or time of day.

When the value of the Mask property is an empty string (""), the control behaves like a standard text box control. When an input mask is defined, underscores appear beneath every placeholder in the mask. You can only replace a placeholder with a character that is of the same type as the one specified in the input mask. If you enter an invalid character, the masked edit control rejects the character and generates a ValidationError event

Character

Description

#

Digit placeholder

.

Decimal placeholder. The actual character used is the one specified as the decimal placeholder in your international settings. This character is treated as a literal for masking purposes

,

Thousands separator. The actual character used is the one specified as the thousands separator in your international settings. This character is treated as a literal for masking purposes

:

Time separator. The actual character used is the one specified as the time separator in your international settings. This character is treated as a literal for masking purposes

/

Date separator. The actual character used is the one specified as the date separator in your international settings. This character is treated as a literal for masking purposes

\

Treat the next character in the mask string as a literal. This allows you to include the '#', '&', 'A', and '?' characters in the mask. This character is treated as a literal for masking purposes

&

Character placeholder. Valid values for this placeholder are ANSI characters in the following ranges: 32-126 and 128-255

>

Convert all the characters that follow to uppercase

<

Convert all the characters that follow to lowercase

A

Alphanumeric character placeholder (entry required).For example: a – z, A – Z, or 0 – 9

a

Alphanumeric character placeholder (entry optional)

9

Digit placeholder (entry optional). For example: 0 – 9

C

Character or space placeholder (entry optional). This operates exactly like the & placeholder, and ensures compatibility with Microsoft Access

?

Letter placeholder. For example: a – z or A – Z

Literal

All other symbols are displayed as literals; that is, as themselves

Mask

Description

Null string

(Default) No mask. Acts like a standard text box.

##-???-##

Medium date (US). Example: 20-May-92

##-##-##

Short date (US). Example: 05-20-92

##:## ??

Medium time. Example: 05:36 AM

##:##

Short time. Example: 17:23