VALIDATE( ) method

Executes any validation tests established in a database or specified by the VALIDATE option of the Format phrase.

Return type: LOGICAL

Applies to: BROWSE widget (browse and column), COMBO-BOX widget, DIALOG-BOX widget, EDITOR widget, FILL-IN widget, FRAME widget, RADIO-SET widget, SELECTION-LIST widget, SLIDER widget, TOGGLE-BOX widget

Syntax

VALIDATE ( [ "ENABLED-FIELDS" ] )

"ENABLED-FIELDS": Validate enabled fields only.

If this option does not appear, the VALIDATE method validates all fields, whether enabled or not.

For a supported field-level widget, this method executes the validation test associated with the underlying field or variable.

For a frame or dialog box, this method executes the validation tests for every supported field-level widget in the frame or dialog box (except the browse, which you must VALIDATE explicitly). If the test for any field-level widget in the frame fails, the AVM displays the validation message and gives focus to the first widget in the frame or dialog box that is both visible and sensitive and whose data has failed validation.

For a browse, VALIDATE executes all validation tests associated with the browse and its children.

Note: During data entry, any widget that receives input focus is always validated. This method allows your procedure to validate any and all widgets in a frame, whether or not they currently have input focus.

If the validation is successful, the method returns TRUE. Otherwise, it returns FALSE.