ValidationTextBox

Property	Description
AcceptsReturn	See Text Entry
Background	See Common Properties
BorderBrush	See Common Properties
BorderThickness	See Common Properties
CompletionRegex	Select from the pre-defined regular expressions. Show list     Examples Regex type Description Matches Non-Matches Credit Card number Checks if it contains 16 numbers in groups of 4 separated by -, ,or nothing 1111-2323-2312-3434 1234343425262837 1111 2323 2312 3434 1111 2323 2312-3434 34323423 1111-2323-23122-3434 Decimal numbers Decimal numbers 1 123 132.132 1.2.2 -123 Domain Names Domains based on latest specifications (RFCs 952 and 1123) regexlib.com this.is.a.museum 3com.com notadomain-.com helloworld.c .oops.org Dutch postcode 4 digits followed by max. two spaces end ending on two letters. 4006 AB 4006ab 4006 AB 4006.ab 4006_ab Email Validation for standard email address e@eee.com eee@e-e.com eee@ee.eee.museum .@eee.com eee@e-.com eee@ee.eee.eeeeeeeeee ISBN-10 Validates the format of an ISBN number ISBN 0 93028 923 4 ISBN 1-56389-668-0 ISBN 1-56389-016-X 123456789X ISBN 9-87654321-2 ISBN 123 456-789X Italian fiscal code Italian fiscal code (codice fiscale) BTTNDR78R06A79QU BTTNDR78R06A79AU Italian phone number italian telephone number with prefix followed by "/", "-" or blank and number 02-343536 02/343536 02 343536 02a343536 02+343536 Multiple email addresses 1 or more email addresses delimited with ',' or ';'. White space is allowed after delimiter lewis@moten.com lewis@moten.com, me@lewismoten.com lewis@moten.com;me@lewismoten.com lewis@@moten.com Numeric values Negatives, comma formatted and a single decimal point values 5,000 -5,000 100.044 xyz Hundred 1.3.4 Spanish phone Validates Spain phone numbers 972367087 97-3770866 972-377086 9988-989898 989898988989 9 9898989898 Spanish postcode Postcode check for Spain 12345 10234 01234 00123 Swedish zipcode With or without space between groups. With leading s- or not. 12345 932 68 S-621 46 5367 425611 31 545 UK bank sort code Validates a UK bank sort code 09-01-29 05-06-25 090125 UK mobile phone number With optional +44 national code. Allows optional brackets and spaces at appropriate positions 07222 555555 (07222) 555555 +44 7222 555 555 7222 555555 +44 07222 555555 (+447222) 555555 UK phone number Allows leading and trailing spaces and optional spaces after the dialing code 01603 123123 0207 1234567 (0208) 123 1234 123 123132 UK Postcode UK postcode validation based on GDSC document EC2V 1JN EC2V 1JN GIR 0AA TB12 1AB EC2V 1JM W2A 1AA US Dollars Handles US Dollars including zero dollars $1,234,567.89 1234567.89 $0.00 $1,2345,67.89 $1234,345,678.0 US social security number U.S. social security numbers, within the range of numbers that have been currently allocated 078-05-1120 078 05 1120 078051120 987-65-4320 000-00-0000 (555) 555-5555000 US telephone number Only area code 939 or 787. Area code parenthesis or hyphens optional (787)755-0114 939-315-0112 7879093849 (098)737-3942 (89)893-2392 939782721 US telephone number with or without area code Validates and also captures AreaCode, Prefix and Suffix for reformatting 5551212 614555-1212 (614)555-1212 A12-5555 (614-555-1212 555*1212 US zip code Standard 5 digit US Zip Codes, or the US ZIP + 4 Standard 48222 48222-1746 4632 Blake 37333-32 This list is drawn from the file C:\Softdial\Scripter2\Designer\ScripterVisualStepTool.xml (on the Scripter Server), and can be adapted to suit your circumstances.
ErrorMessage	The message to be displayed when text is entered that does not match the CompletionRegex or PreviewRegex (whichever contains a valid regex). On selection of a CompletionRegex, a related default ErrorMessage is loaded. This can be edited to suit your circumstances. Text is validated as you type. When text does not match: the control will be highlighted with a thin red border this ErrorMessage will appear as a tooltip when hovering over the control
FontFamily	See Common Properties
FontSize	See Common Properties. Spacing between items is scaled automatically
FontStyle	See Common Properties
FontWeight	See Common Properties
Foreground	See Common Properties
Height	See Common Properties. A vertical scrollbar is created and controlled automatically
HorizontalScrollBarVisibility	Ignored in this control. See the AcceptsReturn property in Text Entry
IsEnabled	See Common Properties
Language	See Common Properties
Margin	See Common Properties
Name	See Common Properties
PreviewRegex	Enter a valid custom regex expression against which the field is to be validated. May be used in conjunction with CompletionRegex. For error condition behaviour, see ErrorMessage
TabIndex	See Common Properties
Text	The text that the field will contain when the page is loaded. The user must overwrite this when entering text.
TextAlignment	Ignored in this control
TextWrapping	See Text Entry
VerticalScrollBarVisibility	Ignored in this control. See the AcceptsReturn property in Text Entry
Visibility	See Common Properties
Width	See Common Properties

Fig. 2 shows the CardCapture screen from the Hotel demo script.

Fig. 2 - ValidationTextBox Control 1

The Card Number field is a ValidationTextBox control.

Notice the following three properties for this control:

1. CompletionRegex - defines the regular expression used to validate the textbox text when the user has completed their input
2. ErrorMessage - defines the message text to be displayed when the user input is invalid
3. PreviewRegex - defines the regular expression used to validate text input on the fly

The CompletionRegex field allows selection of a predefined set of regular expressions for the most common validation requirements (Fig. 3).

Fig. 3 - Validation Text Box 2

These regular expression definitions are stored in the ScripterVisualStepTool.xml file which can be found in the C:\Softdial\Scripter2\Designer folder. Below is an example of an entry in this file.

Note the <errorMessage> and <previewRegex> tags.

• <errorMessage> - defines the text that populates the ErrorMessage property when this regular expression is selected in the CompletionRegex property field. This text is displayed when the user entry is not validated.
• <previewRegex> - defines the regular expression text that populates the PreviewRegex property when a regular expression is selected in the CompletionRegex property field. If populated, this expression is used to provide on-the-fly user input validation. This field may be left blank, or, if the <previewRegex> property is not already defined in the XML document, a regular expression may be entered directly.

  If a regex is entered in the Properties field, it will not be saved to the XML document).

The PreviewRegex and the CompletionRegex will normally be different. For example, the CompletionRegex may validate the format of a fully entered string (e.g. post / ZIP code, etc) while the PreviewRegex may be used to check that only valid characters are being entered.

For a further example of this control, see the Subscripts Tutorial.