Perform Data-Aware Function - GRID SENDMSG() Function 81
Syntax
RESULT$=SENDMSG(sysgui,id,81,row,function${,context{,ERR=lineref}})
Description
This function performs five different operations on a data-aware grid, depending on the value of function$.
|
Parameter |
Description |
|
sysgui |
SYSGUI channel. |
|
id |
Grid control ID. |
|
81 |
Number of this SENDMSG() function. |
|
row |
Row number (zero-based) or ignored. |
|
function$ |
Specific function. $01$ Sets the grid to read-only mode. The row parameter is ignored. See Also BBjGrid::setGridEditable $02$ Flags the specified row as deleted and removes the corresponding record in the MKEYED file. Note that row numbering is zero-based. See Also BBjDataAwareGrid::deleteRow $03$ Adds a row to the grid and enters edit mode, allowing the user to enter a new record. When focus is moved from the edited row, the grid control attempts to write the new record. If the entire primary key is not available, a "Continue/Abort" message box is displayed. The row parameter is ignored. See Also BBjDataAwareGrid::insertRow $04$ Returns the record contained in the specified row. Note that row numbering is zero-based. See Also BBjDataAwareGrid::getRecord $05$ Cancels a record update command. This can also be performed by End Edit - Grid SENDMSG() Function 26. |
If the function$ parameter is $04$, the return value is the specified record. Otherwise, the return value is a one-byte string that indicates the success or failure of an operation; $01$ indicates success, $00$ indicates failure.