Programming Guide - Actian

How You Can Use Data Entry Error HandlersE_PW0013Indicates a data type errorE_PW0027Indicates an input-masking mandatory position error (mandatory positionsof the field are not filled in)The following sections explain how to create data entry error handlers.How You Can Change Values with a Data Entry Error HandlerA data entry error handler can change almost any data it can access. Forexample, it can:• Change the error message to be displayed in a pop-upSetting the error message to an empty string prevents display of the popup.• Reset the field's valueResetting the value removes the error condition (unless you attempt to seta mandatory field's value to an empty value), but does not remove theerror message. The handler generally removes the error message bychanging it to an empty string. However, the handler may replace themessage with a user-defined warning message.Note: Resetting the error field's value in a handler does not clear anypending SetValue events for the field.How You Can Access a Hierarchy of Data Entry Error HandlersOpenROAD lets a called or opened executable object override the handlerspecified by its parent by setting its own data entry error handler. The locallyinvoked error handler can:• Bypass error handlers defined by its parent• Invoke the parent's error handler after executing its own codeWhen a data entry error handler returns control, the error handler can causeOpenROAD to search parent executable objects for other data entry errorhandlers defined at higher levels. OpenROAD calls each handler it finds,passing to it all modifications made by previous handlers. If no handler isfound, execution resumes as if no search for other handlers was performed.Data Entry Error Handling 311