dlgEvent__action__AfterMapQuery

Function called by relation event after querying a map.

Syntax

PUBLIC FUNCTION dlgEvent__action_action_AfterMapQuery( 
   dlg ui.DIALOG, errNo INTEGER, errMsg STRING, mapQuery STRING)

The action part of the function name is defined by the Action property of the relation (under Source UI Settings) . If the Action property is not set, an error will occur at compile time.

The function has four parameters:

  1. dlg. This is a ui.DIALOG object referencing the current dialog. The dialog can implement an INPUT, INPUT ARRAY, DISPLAY ARRAY, MENU, or CONSTRUCT. For more information, see The Dialog class in Genero Business Development Language User Guide.
  2. errNo. This is an SQLCA.SQLCODE error.
  3. errMsg. This is the SQLERRMESSAGE message.
  4. mapQuery. This is the query made to the map.

Usage

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

This function is called when a map is queried.

Example: After Map Query

This example uses the After Map Query code event on a relation. The Action property of the relation is set to checkMap. Every time a user queries a map, a message is displayed.

PUBLIC FUNCTION dlgEvent__action_checkMap_AfterMapQuery(dlg ui.DIALOG, errNo INTEGER, errMsg STRING, mapQuery STRING)

    IF errNo == ERROR_SUCCESS THEN
        DISPLAY "Map query sent: " || mapQuery 
    ELSE
        DISPLAY "ERROR: [" || errNo || "] " || errMsg
    END IF
    
END FUNCTION