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)

Unidraw                                           1 August 1990                                       KeyMap(3U)