Skip to content

Request_AppendRow - cCJGrid

Attempts to append a new row to the end of the grid

Type: Procedure

Syntax

Procedure Request_AppendRow

Call Example

Send Request_AppendRow

Description

Request_AppendRow can be sent to append a new row at the end of the grid.

It will only do this if the following conditions are met:

  1. The SelectedRow can be exited. If the SelectedRow is changed or new, the existing row must be saved or cleared. If this process fails or is canceled, the append request is halted.

  2. The grid allows you to append rows. If pbAllowAppendRow is False, the request will be ignored. In addition, CanAddRow is called and it must return True. CanAddRow will return False if the grid is readonly (pbReadOnly) or if the datasource does not allow adding rows.

Request_AppendRow is not bound directly to an accelerator key, although it can be:

On_Key Key_F11 Send Request_AppendRow

Request_AppendRow is bound indirectly to the kAdd_Mode key (Shift+F10). KAdd_Mode sends Request_InsertRow. If row insertions are not allowed (pbAllowInsertRow is False), but row appends are allowed (pbAllowAppendRow is True), the Request_InsertRow will send the Request_AppendRow message.