pbAutoAppend - cCJGrid
Determines if rows are appended automatically after saving a new row or entering an empty grid
Type: Property
Access: Read/Write
Data Type: Boolean
Parameters: None
Syntax
Property Boolean pbAutoAppend
| Access Type | Syntax |
|---|---|
| Read Access: | Get pbAutoAppend to BooleanVariable |
| Write Access: | Set pbAutoAppend to BooleanVariable/Value |
Description
pbAutoAppend is used to make the process of adding new rows easier. When true, this is used in two ways.
Upon entering an empty grid, a new empty row is added. This will only happen if adding or inserting rows is allowed (pbAllowInsertRow or pbAllowAppendRow is true and pbReadOnly is False). This is done under the assumption that the first thing the user will want to do upon entering a grid is to add data.
If you are entering data into a new row and you complete the data entry by pressing Tab to navigate from the last enterable column to the first enterable column in the next row, pbAutoAppend will open up a row for editing. This allows users to quickly add multiple rows. This only occurs if pbAutoSave is true.
If pbAutoAppend is false, you can always add new rows explicitly by sending Request_InsertRow or Request_AppendRow. These messages are tied to user actions. Pressing Shift+F10 will call Request_InsertRow, which will insert or append a row. Moving to the last row and pressing the down arrow will append the row by calling Request_AppendRow. Clicking below the last row will append the row by calling Request_AppendRow.