Topic       : TOS - The Operating System
Author      : 
Version     : tos.hyp (December 19, 2008)
Subject     : Programmieren/Atari
Nodes       : 3010
Index Size  : 93790
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Title
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File9.1.2.2  cpx_call                                                  TOS

 Name:        »cpx_call« - Calling of the CPX module.

 Declaration  int16_t cdecl (*cpx_call) ( GRECT *work );

              int16_t cdecl (*cpx_call) ( GRECT *work, DIALOG *dialog 
              );

 Description  The call cpx_call is made when the user has selected the 
              corresponding module. The following apply:

               Parameter  Meaning
               work       Rectangle with the coordinates of the 
                          XControl window
               dialog     Pointer to a window dialog

              Note: The second calling procedure is only available 
              under COPS. The parameter dialog in this case contains a 
              pointer to the window dialog structure. The dialog is 
              opened by COPS after the cpx_init with the aid of 
              wdlg_create and wdlg_open. The parameter work and the 
              object tree lie outside the visible screen area up to 
              the first call of Xform_do or up to the return from the 
              cpx_call function.

 Return value: The function returns one of the following values:

                  0  =  End of processing 
               <> 0  =  CPX should continue to be processed 

 Group:       CPX functions

 See also:    XCONTROL