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)

Unidraw                                         20 November 1990                                    UControl(3U)