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:

  1. 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.