RemoveNewSelectedRow - cCJGrid

Removes a new selected row and selects the next row. Performs a data-loss verify if needed.

Type: Function
Return Data Type: Boolean

Syntax

Function RemoveNewSelectedRow Returns Boolean

Call Example

Get RemoveNewSelectedRow to BooleanVariable

Description

RemoveNewSelectedRow is called to remove a new SelectedRow. This is used by the row changing logic to remove a new row when needed. It is also used by Request_Clear and Request_Delete to remove a new row.

Before a row change can occur, any changes in a row must be saved or cleared as determined by pbAutoSave. If pbAutoSave is False, new rows must be removed and this is done by calling RemoveNewSelectedRow.

If the new row is changed, RemoveNewSelectedRow will call the Verify_Data_Loss message, which allows you to present a data-loss confirmation message. If Verify_Data_Loss returns True, the remove row process is cancelled.

RemoveNewSelectedRow can only be called if the SelectedRow is new. If this is not the case, an unhandled error will be displayed. You will rarely send this message. If you wish to clear a new row, you can do so by sending Request_Clear.

Return Value

Returns False if the row was removed, True if cancelled and not removed.