Home > Language Reference > Classes > Application

CustomLaunch Event

Custom application launch.

Syntax

Protected Event CustomLaunch(ByRef lRetVal As Long, ByVal lLaunchCode As Long, ByVal objParams As StreamMemory)

Remarks

Your application is started with this event as it receives a launch code that does not correspond to any of the codes predefined by Palm^® OS and handled by HB++. You can refer to the documentation of the Palm^® OS development kit for more information on launch codes.

The lLaunchCode parameter holds the numeric value of the code with which your application was started, whereas the objParams parameter holds the data transmitted in the parameter block. Precise signification of these two parameters depends on your application, and is not interpreted by HB++.

The lRetVal parameter allows you to specify an exit code for your application, which will be returned to the calling application. Only the 16 least significant bits are used. By default, this value is zero.

This event is typically used in order to get two applications communicating. You can refer to the page dedicated to the Shell method for an example of usage.

System requirements