etMaskTest Sample Program

TeleTools

The information in the property  etLine.Call.<>.Number is formatted acording to a mask in the property etLine.Call.<>.MaskNumber. 

The default value of this property will cause the etLine.Call.<>.Number to to be formated acording to US and Canadian phone numbers.

 

Using This Sample Program
Download this Sample Program 
Release Notes

Development Environment Technical Information
Telephony Hardware Technical Information

 

Using This Sample Program

This program is intended for use with ExceleTel TeleTools v3.6 or later.

The information in the etLine.Call.<>.Number sub-property is formatted acording to the mask. The default value of this property will cause the etLine.Call.<>.Number to to be formated acording to US and Canadian phone numbers; 

'000-000-0000;0;*'

In order to obtain the raw data use the following format: 

';0;*'

The string consists of three fields with semicolons separating them. The first part of the mask is the mask itself. The second part is the character that determines whether the literal characters of the mask are matched to characters in the Value parameter or are inserted into the Value string. The third part of the mask is the character used to represent missing characters in the mask.

These are the special characters used in the first field of the mask:

Character

Meaning in mask

! If a ! character appears in the mask, optional characters are represented in the returned string as leading blanks. If a ! character is not present, optional characters are represented in the returned string as trailing blanks.
> If a > character appears in the mask, all characters that follow are in uppercase until the end of the mask or until a < character is encountered.
< If a < character appears in the mask, all characters that follow are in lowercase until the end of the mask or until a > character is encountered.
<> If these two characters appear together in a mask, no case checking is done and the data is formatted with the case present in the Value parameter.
\ The character that follows a \ character is a literal character. Use this character to use any of the mask special characters as a literal.
L The L character requires an alphabetic character only in this position. For the US, this is A-Z, a-z.
I The l character permits only an alphabetic character in this position, but doesn't require it.
A The A character requires an alphanumeric character only in this position. For the US, this is A-Z, a-z, 0-9.
a The a character permits an alphanumeric character in this position, but doesn't require it.
C The C character requires an arbitrary character in this position.
c The c character permits an arbitrary character in this position, but doesn't require it.
0 The 0 character requires a numeric character only in this position.
9 The 9 character permits a numeric character in this position, but doesn't require it.
The # character permits a numeric character or a plus or minus sign in this position, but doesn't require it.
: The : character separates hours, minutes, and seconds in times. If the character that separates hours, minutes, and seconds is different in the regional settings of the Control Panel, that character is substituted in the returned string.
/ The / character separates months, days, and years in dates. If the character that separates months, days, and years is different in the regional settings of the Control Panel, that character is substituted in the returned string.
; The ; character separates the three fields of the mask.
_ The _ character automatically inserts spaces into the returned string.

Any character that does not appear in the preceding table can appear in the first part of the mask as a literal character. Literal characters are inserted automatically if the second field of the mask is 0, or matched to characters in the Value parameter if the second field is any other value. The special mask characters can also appear as literal characters if preceded by a backslash character (\). The second field of the mask is a single character that indicates whether literal characters from the mask are included in the Value parameter. For example, the mask for a telephone number with area code could be the following string:

(000)_000-0000;0;*

The 0 in the second field indicates that the Value parameter should consist of the 10 digits of the phone number, rather than the 14 characters that make up the final formatted string.

A 0 in the second field indicates that literals are inserted into the Value string, any other character indicates that they should be included. The character to indicate whether literals should be included can be changed by changing the MaskNoSave typed constant that is declared in the Mask unit.

The third field of the mask is the character that appears in the returned string for blanks (characters that do not appear in Value). By default, this is the same as the character that stands for literal spaces. The two characters appear the same in the returned string.

Download this Sample Program

For Use TeleTools v3.6 or later

File

Purpose

EXE

Ready to run!

   

Release Notes

April 22, 2003

Published