uctrls(3U)						    InterViews Reference Manual 						uctrls(3U)

NAME

       CommandControl, PanelControl, HPanelControl, VPanelControl, CommandInteractor, PanelInteractor - predefined UControl and UControlInteractor
       subclasses for common controls

SYNOPSIS

       #include <Unidraw/uctrls.h>

DESCRIPTION

       CommandControl is a UControl subclass that executes a Command.  CommandControl instances are most commonly used in menus.   CommandInterac-
       tor is a UControlInteractor subclass that CommandControls create to define their appearance.

       PanelControl is a subclass of UControl that provides a radiobutton-like interface to selecting from a set of mutually-exclusive choices.  A
       PanelControl is passed an interactor when it is created to define its appearance.  PanelControls are often used to create  ``palettes''	of
       interactors that engage the current Tool instance.

       PanelInteractor is a UControlInteractor subclass that defines an appearance that is often appropriate for PanelControls.  HPanelControl and
       VPanelControl are subclasses of PanelControl that use PanelInteractor instances by default.

COMMANDCONTROL PUBLIC OPERATIONS

       CommandControl(ControlInfo*)
       CommandControl(const char*, ControlInfo*)
	      Create a CommandControl, optionally supplying an instance name.  The constructors automatically create and insert a  ControlInterac-
	      tor to define the CommandControl's appearance.

       virtual void Do()
	      If the ControlInfo's owner is a reversible command, then Do will create a copy of the command, execute it, and log it (if it remains
	      reversible following execution).	If the owner is an irreversible command, then Do will execute it without copying or logging it.

COMMANDINTERACTOR PUBLIC OPERATIONS

       CommandInteractor(ControlInfo*)
	      Create a CommandInteractor with the given ControlInfo object.  The CommandInteractor displays the ControlInfo's label  and  keylabel
	      side-by-side as would befit a menu entry.

PANELCONTROL PUBLIC OPERATIONS

       PanelControl(Interactor*, ControlInfo*, ControlState* = nil)
       PanelControl(
	   const char*, Interactor*, ControlInfo*,
	   ControlState* = nil
       )
	      Create  a  PanelControl,	supplying an interactor that defines its appearance, a ControlInfo object, and optionally an instance name
	      and a ControlState, which all PanelControls in a palette should share to ensure mutual exclusion.

       virtual void Do()
	      Do simply calls Down.  Thus when the KeyMap executes the keyboard equivalent specified in the ControlInfo, it has the same effect as
	      clicking on the PanelControl instance.

PANELCONTROL SUBCLASS PUBLIC OPERATIONS

       HPanelControl(ControlInfo*, ControlState* = nil)
       HPanelControl(const char*, ControlInfo*, ControlState* = nil)

       VPanelControl(ControlInfo*, ControlState* = nil)
       VPanelControl(const char*, ControlInfo*, ControlState* = nil)
	      HPanelControls and VPanelControls simply create an instance of PanelInteractor and pass it to the PanelControl constructor.  HPanel-
	      Controls should be used in row-oriented palettes, and VPanelControls should be used in column-oriented palettes.

PANELINTERACTOR PUBLIC OPERATIONS

       PanelInteractor(ControlInfo*, Orientation)
	      Create a PanelInteractor with the given orientation and ControlInfo object. The PanelInteractor will draw the ControlInfo's label in
	      the  center  of  its  canvas and the keylabel in the lower right.  Horizontal orientation is appropriate for row-oriented instances,
	      while Vertical orientation is appropriate for column-oriented instances.

SEE ALSO

       Command(3U), ControlInfo(3U), KeyMap(3U), Tool(3U), UControl(3U), globals(3U)

Unidraw 							 20 November 1990							uctrls(3U)