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 Utility Functions
Set_Evnt_Mask()                                                    XCONTROL

Syntax

VOID (*xcpb->Set_Evnt_Mask)( mask, m1, m2, time )
WORD mask;
MOBLK *m1;
MOBLK *m2;
LONG time;

Function      Set_Evnt_Mask() defines which events an Event CPX will
              process with its callback functions.

Parameters    mask is a bit mask of events (MU_MESAG, MU_TIMER, etc... )
              that the CPX wishes to process as in evnt_multi(). m1 and m2
              point to MOBLK structures which define mouse rectangles to
              wait for if the CPX wishes to wait for MU_M1 and/or MU_M2
              events as in evnt_mouse(). MOBLK is defined as follows:

              typedef struct
              {
               WORD m_out; /* 0 = enter, 1 = exit */
               WORD m_x;
               WORD m_y;
               WORD m_w;
               WORD m_h;
              } MOBLK;

              time specifies the length of time to specify for the
              MU_TIMER event if appropriate.

Binding       (*xcpb->Set_Evnt_Mask)( mask, m1, m2, time );

Comments      This function is only valid for Event CPX's.

Group         XCONTROL Utility Functions