Equinox Online Help - Language Reference - A to Z
StartInsert |
|
|---|---|
| Applies to |       |
| Syntax | StartInsert [SwitchExpression] |
| Action | [Statement] Creates a new record and allows you to enter field values. |
| Scope | Only usable in form methods, but not in subtables. |
| Notes | This statement inserts a new record into the current table and allows you to enter field values. This statement has the same effect as selecting the Insert option from the form's Record menu. If the optional argument SwitchExpression is evaluated to True, then the new record is a duplicate of the previously selected record. If the argument is False, or omitted, then the new record's fields are initially blank. If the form is already in edit/ insert mode, an error number is stored in the system workarea SysError. |
| Category | Record data entry |
| See Also | Zoom, Find, FindText, GetFindValues, IsInsertMode, RestoreRecord, SaveRecord, SetFindValues, SetInsertMode, StartEdit, UpdateDisplay |
| Example | This example checks that the operator is not already editing and then inserts a new record. if SysMode = NoMode, ViewMode thenStartInsertend if |