The following triggers apply to forms in C/SIDE.
C/SIDE Form Triggers
The following table lists the form triggers and when they are executed.
Form trigger name | Executed |
---|---|
The form is loaded, but before the controls are available. |
|
The form is initialized (the controls are available). |
|
The form is about to close, but before OnCloseForm Trigger. If this trigger returns false, the form is not closed. The intended use is to ask the user if they really want to close the form. |
|
The form is about to close, and after OnQueryCloseForm Trigger. |
|
The form is activated, that is, when the form becomes the active window. |
|
The form is no longer the active window. |
|
The form is opened and a record is retrieved and also when the user chooses to go to the first or the last record. |
|
The system determines how to select the next record, for example after a user presses PAGE DOWN (in a card form). |
|
A record has been retrieved but not yet displayed. |
|
The current record is retrieved. In a table box, OnAfterGetRecord Trigger is called for all the records displayed, while this trigger is called for the current record. |
|
A record is about to be saved. |
|
A new record has been initialized but not yet displayed. |
|
A new record is about to be inserted in the table. |
|
A record is about to be modified in the table. |
|
A record is about to be deleted from the table. |
|
After the OnOpenForm Trigger and after the time specified in the TimeInterval property of the form has elapsed. |
|
You create a URL to a form so that you can send it by e-mail or paste it on your desktop. |
|
You click a hyperlink and after the OnInit Trigger is executed. |
The preceding table only shows the main function of each trigger.
Note |
---|
OnInsertRecord Trigger, OnModifyRecord Trigger, and OnDeleteRecord Trigger, correspond to triggers at the table level. If you use triggers at both the form and table level, the triggers at the form level are executed first. |