dlgEvent_action_AfterClosingTheForm

Function called by relation event after closing the form.

Syntax

PUBLIC FUNCTION dlgEvent_action_AfterClosingTheForm( 
   uiMode SMALLINT )

The function has one parameter:

uiMode. This is an integer value defining the current mode or state in relation to user action in the dialog, form, or application. Modes are defined as constants in the libdbappFormUI file in the libdbapp library.

Table 1. UI modes
Description	Applies to ...	Constant	Value
Display	`DISPLAY ARRAY`	C_MODE_DISPLAY	1
Modify	`INPUT \ INPUT ARRAY`	C_MODE_MODIFY	2
Add	`INPUT \ INPUT ARRAY`	C_MODE_ADD	3
Search	`CONSTRUCT`	C_MODE_SEARCH	4
Empty	`MENU`	C_MODE_EMPTY	5
Exit form	The form	C_MODE_EXIT_FORM	6
Exit app	The app	C_MODE_EXIT_APP	7
Undefined	All (array, form, or app)	C_MODE_UNDEFINED	0

Usage

When you select the After Closing The Form property for the creation of the event, a function shell is created. Enter your code in the function.

This function is called at the close of the form.

Example: After Closing The Form

This example uses the After Closing The Form code event for a relation to the OrderLoginCustomForm form in the OfficeStore demo.

In the example the uiMode is displayed and the connection to a database is closed.

PUBLIC FUNCTION dlgEvent__action__AfterClosingTheForm(uiMode SMALLINT)

    CALL libdbappCore.log(C_LOG_INFO, "dlgEvent__action__AfterClosingTheForm (BA Relation scope) is raised")
    DISPLAY "uiMode :", uiMode
    DISCONNECT "auth1"
    CALL libdbappCore.log(C_LOG_INFO, "dlgEvent__action__AfterClosingTheForm (BA Relation scope) is exited")

END FUNCTION

For more information on the libdbappCore.log() function, go to DBAPPDEBUG and the debug level API.