netbsd man page for selecttool

SelectTool(3U)						    InterViews Reference Manual 					    SelectTool(3U)

NAME

       SelectTool - tool for modifying an editor's current selection

SYNOPSIS

       #include <Unidraw/Tools/select.h>

DESCRIPTION

       SelectTool lets a user change the current selection by direct manipulation, thus affecting the enclosing editor's selection object.  A sin-
       gle click directly on a component view selects that view and unselects all others.  Clicking while holding the Shift key down adds the tar-
       get component to the selection if it was not already selected and removes it if it was selected.  The user can select all components within
       a rectangular area in the viewer by clicking somewhere outside the nearest component and dragging to specify  the  rectangular  area.   All
       components completely within the area will be selected.

PUBLIC OPERATIONS

       SelectTool(ControlInfo* = nil)
	      Create a new SelectTool.

       virtual Manipulator* CreateManipulator(
	  Viewer*, Event&, Transformer*
       )

       virtual void InterpretManipulator(Manipulator*)
	      If  the user did not click on a component, then CreateManipulator creates a DragManip with a RubberRect for dragging out a rectangu-
	      lar area.  Otherwise, CreateManipulator clears the editor's selection and selects the hit component.  If the user  holds	the  Shift
	      key down in either case, the components that would have otherwise been selected will be unselected, and vice versa.  InterpretManip-
	      ulator will only be called if CreateManipulator returned a non-nil manipulator; in this case InterpretManipulator will  examine  the
	      DragManipulator's RubberRect and select the component views falling completely within it.

PROTECTED OPERATIONS

       virtual void Localize(Selection*, Viewer*)
	      Localize	ensures  that the given selection object contains only those views displayed in the given viewer.  CreateManipulator calls
	      this function to avoid possibly shift-selecting views from different components.

SEE ALSO

       Editor(3U), Rubband(3I), Selection(3U), Tool(3U), Viewer(3U), manips(3U)

Unidraw 							  24 January 1991						    SelectTool(3U)