Topic       : The ATARI Compendium
Author      : Scott Sanders / JAY Software
Version     : 1.25 (20/6/2003)
Subject     : Documentation
Nodes       : 1117
Index Size  : 32614
HCP-Version : 6
Compiled on : Atari
@charset    : UTF-8
@lang       : en
@default    : 
@help       : %About
@options    : +g -i -t4 +y +z
@width      : 100
View Ref-FileXCONTROL Callback Functions
cpx_call()                                                         XCONTROL

Syntax

BOOLEAN (*cpx_call)( work )
GRECT *work;

Function      cpx_call() is called immediately after the cpx_init()
              function when the user activates the CPX.

Parameters    Upon entry, the GRECT structure pointed to by work contains
              the current rectangular extent of the control panel window
              work area.

Binding       cpxinfo.cpx_call = cpx_call;

              return ( &cpxinfo );

Return Value  The cpx_call() function should return TRUE if it wants to
              continue processing events through the event handlers
              specified in the CPXINFO structure or FALSE to indicate the
              CPX is finished.

Comments      When exiting the cpx_call() function, the CPX must
              deallocate any allocated memory and close any VDI
              workstations opened.

Group         XCONTROL Callback Functions