The InsertRow event is triggered for a table field when the user automatically appends a row to the bottom of the table field.

tablefieldname is optional if you specify this event in a field script for a table field.

Use the CurFrame system variable to access these attributes. For more information, see FrameExec Class.

Usage: The InsertRow event is defined for table fields only.

The InsertRow event inserts a new row into the table field before executing the event block. In addition, the newly created row becomes the current row in the table field. Any operations that you perform against the current row in the event block are performed against the new row.

For example, to fill in code default values for new rows, you might specify the following code:

If you define both InsertRow and ChildEntry events on a table field, the InsertRow event is triggered first.

The InsertRow event is not triggered for Insert Row operations performed on nested table fields.

You can turn off the automatic append operation in the property sheet for the table field or in your 4GL code using the table field's CurOps attribute. For information about how to make these changes in your 4GL code, see the Programming Guide.

You can modify the table field's ControlButton code for detecting inserts from the ControlButton menu. For more information, see the Programming Guide.