Form dialog events
Reference topic for the form dialog code events set.
Event | Use when ... | Function |
---|---|---|
On Open Form | Use this code event to initialize the form, set up Toolbars, Menus, and so on. | dlgEvent_OnOpenForm |
On Action States Update (Form) |
Use this code event to manage the action state for actions defined for the form, by setting an
action as active ( The pre-defined actions for a form include:
If you have other actions defined for the form, you can also set their state in this code event. The state of an action is determined by the relation setting (disable Add, disable Modify, disable Delete, disable Search). This event is triggered after UI synchronization following validation of a CRUD operation. |
dlgEvent_OnActionStatesChange |
Before Browse Dialog |
Use this code event to display messages to the user, initialize program variables, and set up the dialog instance by deactivating actions the user is not allowed to execute. This event is triggered at the startup of a dialog for display ( |
dlgEvent_Before_BrowseDialog |
After Browse Dialog |
Use this code event to implement dialog finalization code. This event is triggered before the dialog for display ( |
dlgEvent_After_BrowseDialog |
Before Edit Dialog |
Use this code event to display messages to the user, initialize program variables, and set up the dialog instance by deactivating actions the user is not allowed to execute. This event is triggered at startup of a dialog for input ( |
dlgEvent_Before_EditDialog |
After Edit Dialog |
Use this code event to validate a field value, and give control back to the dialog if the value is not as expected. This event is triggered before the dialog for input ( |
dlgEvent_After_EditDialog |
Before Search Dialog |
Use this code event to enable or disable actions and fields, or to give the focus to a specific field. This event is called before the program gives control of the dialog ( |
dlgEvent_Before_SearchDialog |
After Search Dialog |
Use this event to check the content of the fields used in the search ( This event is called after a user has entered search criteria. |
dlgEvent_After_SearchDialog |
Before Empty Dialog |
Use this event to enable or disable actions, or to display a message to the user. This event is called if the Open Mode property for a form (under UI Settings) or relation (under Destination UI Settings) is set to EMPTY (empty mode, without data.) |
dlgEvent_Before_EmptyDialog |
On Action Accept | Use this event to overwrite the predefined action to accept the current dialog. | dlgEvent_OnActionAccept |
On Action Cancel |
Use this event to overwrite the predefined action to cancel the current dialog. |
dlgEvent_OnActionCancel |
On Action Close |
Use this event to overwrite the predefined action to close the current dialog. This event is triggered if the user closes the window. |
dlgEvent_OnActionClose |
On Action Exit |
Use this event to overwrite the predefined action to exit the current dialog. |
dlgEvent_OnActionExit |
On Action New |
Use this event to overwrite the predefined action to insert a new row in the current dialog. |
dlgEvent_OnActionNew |
On Action Query |
Use this event to overwrite the predefined query by example (search) action in the current dialog. The query by example action is available in the "DISPLAY", "MODIFY", "ADD", and "EMPTY" modes. |
dlgEvent_OnActionQuery |