Legacy Document

Inside Macintosh: Macintosh Toolbox Essentials /

Chapter 2 - Event Manager / Event Manager Reference

Event Manager Routines / Receiving Events

SetEventMask

The SetEventMask procedure sets the system event mask of your application to the specified mask. Your application should not call the SetEventMask procedure to disable any event types from being posted. Use SetEventMask only to enable key-up events if your application needs to respond to key-up events.

PROCEDURE SetEventMask (theMask: Integer);

theMask

An event mask that specifies which events should be posted in the Operating System event queue.

DESCRIPTION

The SetEventMask procedure sets the system event mask of your application according to the parameter theMask. The Operating System Event Manager posts only low-level events (other than update or activate events) corresponding to bits in the system event mask of the current process when posting events in the Operating System event queue. The system event mask of an application is initially set to post mouse-up, mouse-down, key-down, auto-key, and disk-inserted events into the Operating System event queue.

ASSEMBLY-LANGUAGE INFORMATION

The system event mask of the current application is available in the SysEvtMask system global variable.

SEE ALSO

For additional information on event masks, see "Setting the Event Mask" beginning on page 2-26.