OnNewRecord Trigger

Runs after a new record is initialized, but before it is inserted as a record in the table.

Syntax

trigger OnNewRecord(BelowxRec)
begin
    ...
end;

Parameters

BelowxRec
(Boolean) This return value indicates whether the new record is to be inserted after the last record in the table (xRec). If false, the record is to be inserted between an existing record and the last record. If true, the record is to be inserted below the last record in the table (xRec).

Applies To

  • Pages

Remarks

Use this trigger to initialize a new record or other variables on the page. This is run before users enter any data in the record.

If an error occurs in the trigger code a popup dialog shows an error message. When the dialog is closed, the user can enter new data.

Important

For pages of the type Card, List, ListPlus, Document, or Worksheet, the OnNewRecord trigger is called more than once if the page is opened in the edit mode and does not have any records to display. If the page is opened in the view mode or displays a record, the trigger is called only once.

Note

The OnNewRecord trigger does not support calls to control add-in methods and properties because the trigger is invoked before the page is instantiated.

See Also

Triggers