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 single click  directly  on  a  component  view
       selects  that  view  and  unselects all others.  Clicking while holding the Shift key down
       adds the target 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  rectangular  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.  InterpretManipulator
              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)