KeyMap  -  activates controls given their keyboard equiva-
       lents

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 acti-
       vate a control given its key code as defined by  its  Con-
       trolInfo  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  regis-
              trants.

       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 reg-
              istering  all its registered controls individually.

       void Execute(const char* keyCode)
              Execute the given key code by activating the corre-
              sponding  control.   Each  UControl contains a Con-
              trolInfo 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)