Skip to content

CanNavigateIntoColumn - cCJGridColumn

Returns true if this column can be given the focus via Next or Previous keyboard navigation

Type: Function
Return Data Type: Boolean

Parameters

Parameter Type Description
bForward Boolean Indicates if the navigation event is forward (True) or backwards (False)

Syntax

Function CanNavigateIntoColumn Boolean bForward Returns Boolean

Call Example

Get CanNavigateIntoColumn bForward to BooleanVariable

Description

CanNavigateIntoColumn is sent to a column to determine if it can take the focus via a Next or Previous keyboard navigation. It is passed the navigation direction in bForward and it returns true if the object can take the focus.

With non-data aware grids (cCJGrid/cCJGridColumn), this will return true if the column is Editable (pbEditable) and focusable (IsColumnFocusable). With data aware grids (cDbCJGrid/cDbCJGridColumn), an additional check is made to support SkipFound with forward navigation. If the column is a SkipFound column (which is determined by the data dictionary), columns that already have a found record will return False.

This method is called by the NextColumn and PreviousColumn methods, which are called by the grid's Next and Previous messages, as well as FirstEnterableColumn and LastEnterableColumn.

CanNavigateIntoColumn is suitable for augmentation.

Return Value

Returns true if this column is a candidate for this focus change.