You are here:

Softdial Scripter™ Page Editor

ValidationTextBox

Fig. 1 - ValidationTextbox control

A control that allows the script user to enter text, which is validated against regular expressions (standard .NET variety ), either

pre-defined (see CompletionRegex)
custom (see PreviewRegex) or
both

This feature is required for any kind of user input that must conform to a specific set of criteria such as credit card numbers, email addresses, telephone numbers and also customised formats that may apply, such as customer account numbers and policy numbers.

Properties that are common to this and many other controls are described in Common Properties.

ValidationTextBox properties

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

Regex type	Description	Matches	Non-Matches
		Examples
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

For more details on usage, see Scripter Designer Updates - V10.5.