Document:     keyevents

Purpose:      Describes routines for handling user input keyword events

Category:     SYSTEM, USER-INTERFACE
              
File:         keyevents.c
             
Author:       J.P. Terlouw
            
Description:  The routines in this source allow a task to specify ("schedule")
              one or more functions to be called when Hermes generates an
              event associated with a user input keyword.
              Such an event can be one of the following:
              - user input keyword change;
              - user input keyword cancel;
              - user input keyword reject;
              
              The following routines are available:

              ScheduleKeyevent     - schedule function for receiving events
              DescheduleKeyevent   - deschedule function           
              SuppressKeyevent     - suppres call to function

Related doc:  MainLoop.dc2

Updates:      Apr 18, 1997: JPT, Document created.
              Jun 28, 1998: JPT, Implemented hash table.
              Oct  7, 1999: JPT, Implemented SuppressKeyevent.
              Nov 11, 1999: JPT, SuppressKeyevent bug fix.
              May  4, 2001: JPT, Synchronization with other task's wkey calls.