ShowControlError - cWebBaseDEO

Shows field errors for non-data-bound fields

Type: Procedure

Parameters: Integer iErrNum String sErrText

ParameterDescription
iErrNumError number to show
sErrTextError text to show


Syntax
Procedure ShowControlError Integer iErrNum String sErrText

Call: Send ShowControlError iErrNum sErrText


Description

The framework allows field errors to be shown on non-data-bound fields using the ShowControlError and HideControlError procedures. Note that a WebSet of psValue and a successful OnValidate event clears all the errors. HideAllControlErrors can be used to hide all errors. Combining this with the OnValidate event allows the developer to implement field validations that behave the same as on a data-aware field.

Object oForm is a cWebForm
    Set piColumnSpan to 6
    Set psLabel to "5 characters:"
    Set pbServerOnValidate to True

    Function OnValidate Returns Boolean
        Boolean bRetVal
        String sVal

        Forward Get OnValidate to bRetVal

        WebGet psValue to sVal

        If (Length(sVal) < 5) Begin
            Move False to bRetVal

            Send ShowControlError 1 "Please enter more than 5 characters!"
        End

        Function_Return bRetVal
    End_Function
End_Object

The code example above shows how a custom validation can be implemented on a form.