UControl(3U)						    InterViews Reference Manual 					      UControl(3U)

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 key-
       board equivalent for the control.  UControlInteractor is an abstract base class for interactors that base their appearance on the  informa-
       tion 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 equiva-
       lent 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 opera-
	      tion 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)