Function called by relation event after querying a map.


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.


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)

        DISPLAY "Map query sent: " || mapQuery 
        DISPLAY "ERROR: [" || errNo || "] " || errMsg
    END IF