Skip to content

Request_InsertRow - cCJGrid

Attempts to insert a new row above the current SelectedRow

Type: Procedure

Syntax

Procedure Request_InsertRow

Call Example

Send Request_InsertRow

Description

Request_InsertRow can be sent to insert a new row above the current SelectedRow.

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 insert request is halted.

  2. The grid allows you to insert or append rows. If pbAllowInsertRow 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_InsertRow is bound indirectly to the kAdd_Mode key (Shift+F10).

As a special case, if pbAllowInsertRow is False and pbAllowAppendRow is True, Request_InsertRow will send the Request_AppendRow message. This allows the Shift+F10 key to be used for row inserts or row appends.