NAME

       KeyMap - activates controls given their keyboard equivalents

SYNOPSIS

       #include <Unidraw/keymap.h>

DESCRIPTION

       KeyMap  supports  keyboard  equivalents,  which allow the user of a Unidraw application to
       execute menu commands or select from a palette of controls by typing rather than  pointing
       and  clicking  with  the  mouse.  The  KeyMap can activate a control given its key code as
       defined by its ControlInfo object.  Only those controls registered with the KeyMap can  be
       activated  through  the  KeyMap.   By default, the Editor base class handles key events by
       having its KeyMap execute the key code.

PUBLIC OPERATIONS

       KeyMap()
              Construct a new keymap, initially with no registrants.

       void Register(UControl*)
       void Register(KeyMap*)
       void Unregister(UControl*)
       void Unregister(KeyMap*)
              Register and unregister a control or  another  KeyMap.   Registering  a  KeyMap  is
              equivalent to registering all its registered controls individually.

       void Execute(const char* keyCode)
              Execute  the given key code by activating the corresponding control.  Each UControl
              contains a ControlInfo object that specifies its key code; thus the mapping between
              key  codes  and  controls  is defined by the ControlInfo objects collectively.  Key
              codes among registered controls should be unique.

SEE ALSO

       ControlInfo(3U), KeyMap(3U), UControl(3U), kybd(3U)