OnNewRecord Trigger
Executed after a new record is initialized, but before users can make entries.
Syntax
OnNewRecord(BelowxRec)
Return Value
BelowxRec
(Boolean) This return value indicates whether the new record was inserted after the last record in the table (xRec). If false, the record was inserted between an existing record and the last record. If true, the record was 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.
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. For more information see, Exposing Methods and Properties in a Windows Client Control Add-in.