// $Revision: 1.5 $
// Copyright (C) 1995 Taligent, Inc. All rights reserved.
#if 0
---------------------------------------------------------------------------
> Class:
 | TSelectionToolInteractor  
> Taxonomy Category:
 | Documented Samples  
 | GlobalSelectinTool  
> Interface Category:
 | Sample.  
> Inherits From:
 | TToolInteractor, MMouseEventHandler 
> Inherited By:
 | None. 
> Purpose:
 | TSelectonToolInteractor interprets events until it is able to definitively determine if the gesture is a selection or drag gesture, at which time it starts a second, subordinate interactor, to complete the gesture.  
> Instantiation:
 | Allocate on the heap or the stack.  
> Deriving Classes:
 | None.  
> Concurrency:
 | _Not_ multithread safe.  
> Resource Use:
 | No special requirements.  
> Other Considerations:
 | None.  
---------------------------------------------------------------------------
#endif
#if 0
---------------------------------------------------------------------------
> Member Function: TSelectionToolInteractor::TSelectionToolInteractor ;
 | TSelectionToolInteractor (MToolHandler * handler)  
> Interface Category:
 | Sample.  
> Purpose:
 | Creates an instance.  
> Calling Context:
 | Called by a tool, a tool handler, or other client.  
> Parameters:
 = MToolHandler * handler -The tool handler that will create targets for the interactor.  
> Return Value:
 | None.  
> Exceptions:
 | Throws no exceptions, passes all exceptions through.  
> Concurrency:
 | _Not_ multithread safe.  
> Other Considerations:
 | None.  
---------------------------------------------------------------------------
#endif
#if 0
---------------------------------------------------------------------------
> Member Function: TSelectionToolInteractor::~ TSelectionToolInteractor ;
 | virtual ~ TSelectionToolInteractor ()  
> Interface Category:
 | Sample.  
> Purpose:
 | Destructor.  
> Calling Context:
 | Called to destroy an object.  
> Parameters:
 = Takes no parameters.  
> Return Value:
 | None.  
> Exceptions:
 | Throws no exceptions, passes all exceptions through.  
> Concurrency:
 | _Not_ multithread safe.  
> Other Considerations:
 | None.  
---------------------------------------------------------------------------
#endif
#if 0
---------------------------------------------------------------------------
> Member Function: TSelectionToolInteractor::MouseDown ;
 | virtual bool MouseDown (TMouseDownEvent &)  
> Interface Category:
 | Sample.  
> Purpose:
 | Handles mouse-down events. This function starts a TRangeSelector if appropriate.  
> Calling Context:
 | Called by the Input system.  
> Parameters:
 = TMouseDownEvent & -The event.  
> Return Value:
 | Returns true if the event was handled.  
> Exceptions:
 | Throws no exceptions, passes all exceptions through.  
> Concurrency:
 | _Not_ multithread safe.  
> Other Considerations:
 | None.  
---------------------------------------------------------------------------
#endif
#if 0
---------------------------------------------------------------------------
> Member Function: TSelectionToolInteractor::MouseMoved ;
 | virtual bool MouseMoved (TMouseMovedEvent & mouseMoved)  
> Interface Category:
 | Sample.  
> Purpose:
 | Handles mouse-moved events. This function starts drag operations if dragging is appropriate.  
> Calling Context:
 | Called by the Input system.  
> Parameters:
 = TMouseMovedEvent & mouseMoved -The event.  
> Return Value:
 | Returns true if the event was handled.  
> Exceptions:
 | Throws no exceptions, passes all exceptions through.  
> Concurrency:
 | _Not_ multithread safe.  
> Other Considerations:
 | None.  
---------------------------------------------------------------------------
#endif
#if 0
---------------------------------------------------------------------------
> Member Function: TSelectionToolInteractor::MouseUp ;
 | virtual bool MouseUp (TMouseUpEvent & mouseUp)  
> Interface Category:
 | Sample.  
> Purpose:
 | Handles mouse-up events. The default behavior simply prepares for and orderly shudown of the interactor and calls SetDone(true).  
> Calling Context:
 | Called by the Input system.  
> Parameters:
 = TMouseUpEvent & mouseUp -The event.  
> Return Value:
 | Returns true.  
> Exceptions:
 | Throws no exceptions, passes all exceptions through.  
> Concurrency:
 | _Not_ multithread safe.  
> Other Considerations:
 | None.  
---------------------------------------------------------------------------
#endif
#if 0
---------------------------------------------------------------------------
> Member Function: TSelectionToolInteractor::DispatchEvent ;
 | virtual bool DispatchEvent (TEvent &)  
> Interface Category:
 | Sample.  
> Purpose:
 | Dispatches events to the appropriate interactor. If a subinteractor has been created to handle selection or dragging, sends events to it.  
> Calling Context:
 | Called by the Input system.  
> Parameters:
 = TEvent & -The event.  
> Return Value:
 | Returns true if the event is handled.  
> Exceptions:
 | Throws no exceptions, passes all exceptions through.  
> Concurrency:
 | _Not_ multithread safe.  
> Other Considerations:
 | None.  
---------------------------------------------------------------------------
#endif