Write the contents of the row buffer to a row in the table.
If the table is in insert mode, a new row will be created using the contents of the row buffer. If the table is in edit mode, the current row will be updated with the contents of the row buffer.
- Returns:
-
- Note:
- each insert and edit must be paired with a post or cancel.
- Precondition:
- The table must be in either DB_TABLE_INSERTING or DB_TABLE_EDITING mode.
- Postcondition:
- When the operation is successful, the table is returned to DB_TABLE_BROWSING mode and the row will be repositioned depending on the InsertFlags setting
If an error occurs, the values can be modified and
post can be called again. Or use
cancel to return to browsing mode.
- See also:
- insert, edit, cancel, remove