Function:      TriggerKey

Purpose:       Re-send keyword to Hermes, causing a KEYCHANGE event

Category:      USER-INTERFACE, SYSTEM

File:          keyevents.c

Author:        J.P. Terlouw

Use:           #include "keyevents.h"
               char *key;
               bool result;

               result = TriggerKey(key);

                  result - TRUE if keyword was actually triggered,
                           i.e. if it was present. Otherwise FALSE.
                  key    - user input keyword

Description:   TriggerKey attempts to read the value associated with the
               user input keyword. If this succeeds, the keyword is re-sent
               to Hermes. In event-driven programs this will result in a
               KEYCHANGE event for the given keyword.
               This routine can be useful e.g. in the initialization phase
               of event-driven programs.

Note:          An other approach in implementing this functionality would
               be calling the event handler(s) directly from this function
               instead of letting Hermes generate the event. This may be
               more efficient, but the implementation chosen is simpler.

Updates:       Mar  6, 1998: JPT, Document created.