NAME

       UControl,  UControlInteractor - base classes for menu and button interfaces that work with
       ControlInfo objects

SYNOPSIS

       #include <Unidraw/uctrl.h>

DESCRIPTION

       UControl is an abstract class that augments InterViews' Control base class  to  deal  with
       Unidraw's  ControlInfo  objects,  which  define  a  keyboard  equivalent  for the control.
       UControlInteractor is an abstract base class for interactors that base their appearance on
       the  information  in a ControlInfo object.  UControl subclasses can use UControlInteractor
       subclasses to define their appearance.

       Unidraw-based applications needn't use UControls and UControlInteractors  to  help  define
       their look and feel if Unidraw's keyboard equivalent mechanism is not needed.

UCONTROL PUBLIC OPERATIONS

       virtual void SetControlInfo(ControlInfo*)
       ControlInfo* GetControlInfo()
              Assign and retrieve the UControl's ControlInfo object.

UCONTROL PROTECTED OPERATIONS

       UControl(ControlInfo*)
       UControl(const char*, ControlInfo*)
              UControl  provides  protected  constructors  that  let  subclasses  initialize  the
              ControlInfo object and optionally specify their instance name.

UCONTROLINTERACTOR PUBLIC OPERATIONS

       virtual void SetControlInfo(ControlInfo*)
       ControlInfo* GetControlInfo()
              Assign and retrieve the UControlInteractor's ControlInfo object.

       virtual void Highlight(boolean)
              The UControlInteractor's appearance is defined by a Graphic object, which it builds
              from  information  in  its  ControlInfo  object.   By  default,  UControlInteractor
              highlights itself by drawing this graphic with its foreground and background colors
              reversed.

UCONTROLINTERACTOR PROTECTED OPERATIONS

       UControlInteractor(ControlInfo*)
       UControlInteractor()
              UControlInteractor  defines  two protected constructors.  One takes the ControlInfo
              object  to  use  as  an  argument.    This   constructor   also   initializes   the
              UControlInteractor's _label protected member by calling InitLabel (described below)
              with the ControlInfo object.  The parameterless constructor initializes  _label  to
              nil.   Both  constructors  initialize  the  UControlInteractor's _picture protected
              member  to  point  to  an  instance  of  a  Picture  object,  which   defines   the
              UControlInteractor's appearance.

       virtual void Invert()
              Invert reverses _picture's colors without drawing it.

       Graphic* InitLabel(ControlInfo*)
              Create  a  graphic from the information stored in a ControlInfo object that defines
              the UControlInteractor's appearance.  This operation creates a GraphicView  of  the
              ControlInfo's GraphicComp and returns a copy of the view's graphic.

SEE ALSO

       Control(3I), ControlInfo(3U), Graphic(3U), GraphicComp(3U), GraphicView(3U), KeyMap(3U)