Skip to content

Request_ClearRow - cCJGrid

Attempts to clear changes in a row

Type: Procedure

Syntax

Procedure Request_ClearRow

Call Example

Send Request_ClearRow

Description

Request_ClearRow attempts to clear changes in a row. This message is indirectly bound to the kClear key (F5). Because the framework expects that the kClear key will send Request_Clear to a data entry object (DEO), the Request_Clear message simply sends Request_ClearRow.

Request_ClearRow performs different tasks based on the state of the row.

If the row is changed, Request_ClearRow will clear the changes and restore the row back to its pre-edited state. It does this by calling RestoreSelectedRow. This may result in a data-loss verification and the clear can therefore be cancelled.

If the row is unchanged and new, Request_ClearRow will remove the row by sending RemoveNewSelectedRow.

If the row is unchanged and not new, Request_ClearRow does nothing.