The Text Box Widget allows users to enter a single line of text.
Text Box Widget
Property Name |
Description |
Is Password |
Does the Text Box represent a password? If this is set to true, then all characters are displayed as an "*". |
Mask |
Used to control what types of text is allowed in the Text Box. If this is blank, then there are no restrictions and all text characters are allowed. See below for more information about the mask. |
Multiline |
Does the Text Box support multiple text lines? This is set to false for a Text Box. |
[All other properties] |
Creating a Mask
Creating a mask is useful for controlling what users can enter into the field. You can either select a pre-defined mask from the Mask property drop down or type in a mask manually. Here as some examples of the pre-defined masks:
Description |
Example Valid Text |
Mask |
Currency |
$1,234.95 |
$9,999.00 |
Numeric (5 digits) |
12345 |
00000 |
Date and time |
12/11/2003 11:20 |
00/00/0000 90:00 |
Phone number |
(574) 555-0123 |
(999) 000-0000 |
Phone number no area code |
555-0123 |
000-0000 |
Social security number |
717-64-1234 |
000-00-0000 |
Zip code |
98052-6399 |
00000-9999 |
Here is a table that describes the special characters that you can use to define a mask:
Masking Character |
Description |
0 |
Required single digit between 0 and 9. |
9 |
Optional single space or digit. |
# |
Optional single space or digit, but if this is not entered by the user it will display as a space. |
L |
Required single capital or lower case letter. |
? |
Optional single capitol or lower case letter. |
& |
Required single character. This can be any printable character. |
C |
Optional single character. This can be any printable character. |
. |
Decimal placeholder. |
, |
Thousands placeholder. |
: |
Time separator. |
/ |
Date separator. |
$ |
Currency symbol. |
All other characters |
These characters will appear as themselves. |