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_hook()                                                         XCONTROL

Syntax

BOOLEAN (*cpx_hook)( event, msg, mrets, key, nclicks )
WORD event;
WORD *msg;
WORD *mrets;
WORD key, nclicks;

Function      cpx_hook() is called in an Event CPX immediately after the
              Control Panel's evnt_multi() function returns before the
              message is processed.

Parameters    All parameters share counterparts with the evnt_multi()
              function. For a detailed explanation of the return values
              please consult the documentation for that function. event
              contains the event mask of one or more events that occurred.
              msg points to an array of eight WORDs containing the message
              buffer. mrets and nclicks point to the mouse event (if any)
              as described in cpx_button(). key points to a WORD
              containing the keyboard scancode of the key pressed (if
              any).

Binding       cpxinfo.cpx_hook = cpx_hook;

              return ( &cpxinfo );

Return Value  The function should return TRUE to override default event
              handling or FALSE to continue processing the message.

Group         XCONTROL Callback Functions