OnValidating - cCJGridColumn

Called as part of the column validation process. Returns True if the column value is invalid.

Type: Event

Return Data Type: Boolean

Parameters: None

Return Value

Returns True if the column value is invalid.


Syntax
Function OnValidating Returns Boolean

Description

The column validation process is called during forward keyboard navigation (Next) and during a row save. A row save may occur explicitly via Request_Save or automatically during a row change.

When validation occurs during Next navigation (i.e., the user pressed the Tab key), the column losing the cell focus will be validated. If the validation fails, the Next navigation is cancelled.

When a save is requested, SaveSelectedRow is called. SaveSelectedRow validates all columns by calling ValidateRow. If any column fails validation, the validation process is halted and the save is cancelled. If the column that failed validation is visible and focusable, it will take the focus.

OnValidating is called as part of the validation process. If it returns true, validation fails.

With data aware grids, the cDbCJGridColumn object will call the data dictionary's field validation logic after it calls OnValidating. Typically, the data dictionary is the preferred place to perform any validation testing. Therefore, OnValidating will be used most often with non-data aware grids.