RetainFocusOnError Property

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Text;
using System.Windows.Forms;
using Infragistics.Win;
using Infragistics.Win.Misc;
using System.Drawing;
using System.Drawing.Drawing2D;

    private const string USPhonePatternLong = @"^\(\d{3}\) \d{3}-\d{4}$";
    private const string USPhonePatternShort = @"^\d{3}-\d{4}$";
    private const string USPostalCodeLong = @"^\d{5}-\d{4}$";
    private const string USPostalCodeShort = @"^\d{5}$";
    private const string USSocialSecurityNumber = @"^\d{3}-\d{2}-\d{4}$";
    private const string EMailPattern = @"^[a-zA-Z][\w\.-]*[a-zA-Z0-9]@[a-zA-Z0-9][\w\.-]*[a-zA-Z0-9]\.[a-zA-Z][a-zA-Z\.]*[a-zA-Z]$";

    private enum ValidationPattern
    {
        EmailAddress,
        USPhoneLong,
        USPhoneShort,
        USPostalCodeLong,
        USPostalCodeShort,
        USSocialSecurityNumber,
    }

    private void AssignPattern( UltraValidator ultraValidator,
                                TextBox textBox,
                                ValidationPattern pattern,
                                bool retainFocusOnError )
    {
        //  Get the appropriate Regex pattern to use
        string regexPattern = string.Empty;

        switch ( pattern )
        {
            case ValidationPattern.EmailAddress:
            {
                regexPattern = EMailPattern;
            }
            break;

            case ValidationPattern.USPhoneLong:
            {
                regexPattern = USPhonePatternLong;
            }
            break;

            case ValidationPattern.USPhoneShort:
            {
                regexPattern = USPhonePatternShort;
            }
            break;

            case ValidationPattern.USPostalCodeLong:
            {
                regexPattern = USPostalCodeLong;
            }
            break;

            case ValidationPattern.USPostalCodeShort:
            {
                regexPattern = USPostalCodeShort;
            }
            break;

            case ValidationPattern.USSocialSecurityNumber:
            {
                regexPattern = USSocialSecurityNumber;
            }
            break;
        }

        //  Get a ValidationSettings instance to be associated with the
        //  specified control. Note that the GetValidationSettings will
        //  create an instance and assign it automatically if the control
        //  is not already associated with an instance.
        ValidationSettings validationSettings = ultraValidator.GetValidationSettings( textBox );

        //  Create an OperatorCondition instance for Regex validation, using the
        //  specified pattern, and assign it to the ValidationSettings' Condition property.
        validationSettings.Condition = new OperatorCondition( ConditionOperator.Match, regexPattern );

        //  Require that the field not be left empty, and specify what the validator
        //  should consider to constitute an empty value.
        validationSettings.IsRequired = true;
        validationSettings.EmptyValueCriteria = EmptyValueCriteria.NullOrEmptyString;

        //  Specify which property of the TextBox should be used to obtain
        //  the value to be validated.
        validationSettings.ValidationPropertyName = "Text";

        //  Set the RetainFocusOnError property according to the caller's specifications.
        validationSettings.RetainFocusOnError = retainFocusOnError;

        //  Use the NotificationSettings to make a MessageBox appear when a validation
        //  fails, and customize the caption for the MessageBox.
        validationSettings.NotificationSettings.Action = NotificationAction.MessageBox;
        validationSettings.NotificationSettings.Caption = "Invalid String Pattern";

        //  Use the Tag property to store the pattern.
        validationSettings.Tag = pattern;

        //  Handle the UltraValidator's ValidationError event so we can customize
        //  the notifications.
        ultraValidator.ValidationError += new ValidationErrorHandler( this.OnPatternValidationError );
    }

    //  Handles the UltraValidator's ValidationError event for Regex pattern validations
    private void OnPatternValidationError( object sender, ValidationErrorEventArgs e )
    {
        //  Get a reference to the Validation object under which the information
        //  about the validation error appears.
        Validation validation = e.Validation;

        //  Return if this is a programmatic validation
        if ( validation.Trigger == ValidationTrigger.Programmatic )
            return;

        //  Get a reference to the ValidationResult object which describes
        //  the reason for failure
        ValidationResult result = validation.Errors[0];

        //  Get the value which caused the validation to fail, so we can include
        //  it in the message that is displayed to the end user.
        string text = result.Value as string;

        //  Get a reference to the ValidationSettings object which was used
        //  to determine that the value is invalid.
        ValidationSettings validationSettings = result.ValidationSettings;

        //  Get a reference to the NotificationSettings object which determines
        //  how the end user will be notified. For single-entity validations, we
        //  can set the properties of this instance, so that the notification
        //  behavior can be customized dynamically.
        NotificationSettings notificationSettings = e.NotificationSettings;

        //  Customize the error message that is displayed to the end user.
        notificationSettings.Text = string.Format( "The value '{0}' for field '{1}' does not conform to the '{2}' pattern.", text, validationSettings.Control.Name, validationSettings.Tag );
    }