// $Revision: 1.5 $
// Copyright (C) 1995 Taligent, Inc. All rights reserved.
#if 0
---------------------------------------------------------------------------
> Class:
 | TSelectionToolTarget  
> Taxonomy Category:
 | Documented Samples  
 | GlobalSelectionTool  
> Interface Category:
 | Sample.  
> Inherits From:
 | MToolTarget 
> Inherited By:
 | TCurrentSelectionTarget 
 | TInsertionTarget 
 | TSelectionTarget 
> Purpose:
 | Defines base functionality for selection tool targets and provides shared feedback implementation.  
> Instantiation:
 | Allocate on the heap or the stack.  
> Deriving Classes:
 | TInsertionTarget, TCurrentSelectionTarget, TSelectionTarget.  
> Concurrency:
 | _Not_ multithread safe.  
> Resource Use:
 | No special requirements.  
> Other Considerations:
 | None.  
---------------------------------------------------------------------------
#endif
#if 0
---------------------------------------------------------------------------
> Member Function: TSelectionToolTarget::TSelectionToolTarget ;
 | TSelectionToolTarget (MFeedbacker * feedbacker, MSelectionMapping * mapping)  
> Interface Category:
 | Sample.  
> Purpose:
 | Constructor for derived classes.  
> Calling Context:
 | Called from derived class constructors.  
> Parameters:
 = MFeedbacker * feedbacker -The feedbacker used by the target.  
 = MSelectionMapping * mapping -The mapping used by the target.  
> Return Value:
 | None.  
> Exceptions:
 | Throws no exceptions, passes all exceptions through.  
> Concurrency:
 | _Not_ multithread safe.  
> Other Considerations:
 | None.  
---------------------------------------------------------------------------
#endif
#if 0
---------------------------------------------------------------------------
> Member Function: TSelectionToolTarget::~ TSelectionToolTarget ;
 | virtual ~ TSelectionToolTarget ()  
> 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: TSelectionToolTarget::GetSelection ;
 | virtual TModelSelection * GetSelection () const  
> Interface Category:
 | Sample.  
> Purpose:
 | Returns a TModelSelection representing the targeted data.  
> Calling Context:
 | Called by a tool.  
> Parameters:
 = Takes no parameters.  
> Return Value:
 | A TModelSelection representing the targeted data.  
> Exceptions:
 | Throws no exceptions, passes all exceptions through.  
> Concurrency:
 | _Not_ multithread safe.  
> Other Considerations:
 | None.  
---------------------------------------------------------------------------
#endif
#if 0
---------------------------------------------------------------------------
> Member Function: TSelectionToolTarget::GetSelectionDisplayArea ;
 | TGArea GetSelectionDisplayArea () const  
> Interface Category:
 | Sample.  
> Purpose:
 | Returns an area that encompasses the part of the screen where the selected data is displayed.  
> Calling Context:
 | Called by a tool.  
> Parameters:
 = Takes no parameters.  
> Return Value:
 | An area that encompasses the part of the screen where the selected data is displayed.  
> Exceptions:
 | Throws no exceptions, passes all exceptions through.  
> Concurrency:
 | _Not_ multithread safe.  
> Other Considerations:
 | None.  
---------------------------------------------------------------------------
#endif
#if 0
---------------------------------------------------------------------------
> Member Function: TSelectionToolTarget::AdoptFeedback ;
 | void AdoptFeedback (MGraphic * graphic)  
> Interface Category:
 | Sample.  
> Purpose:
 | Adds feedback to the feedbacker for display. Any previously adopted feedback is removed and deleted.  
> Calling Context:
 | Called by a tool.  
> Parameters:
 = MGraphic * graphic -The graphic feedback.  
> Return Value:
 | None.  
> Exceptions:
 | Throws no exceptions, passes all exceptions through.  
> Concurrency:
 | _Not_ multithread safe.  
> Other Considerations:
 | None.  
---------------------------------------------------------------------------
#endif
#if 0
---------------------------------------------------------------------------
> Member Function: TSelectionToolTarget::OrphanFeedback ;
 | MGraphic * OrphanFeedback ()  
> Interface Category:
 | Sample.  
> Purpose:
 | Removes the feedback previously adopted.  
> Calling Context:
 | Called by a tool.  
> Parameters:
 = Takes no parameters.  
> Return Value:
 | The orphaned graphic.  
> Exceptions:
 | Throws no exceptions, passes all exceptions through.  
> Concurrency:
 | _Not_ multithread safe.  
> Other Considerations:
 | None.  
---------------------------------------------------------------------------
#endif
#if 0
---------------------------------------------------------------------------
> Member Function: TSelectionToolTarget::ReplaceFeedback ;
 | MGraphic * ReplaceFeedback (MGraphic * newFeedback)  
> Interface Category:
 | Sample.  
> Purpose:
 | Replaces the previously adopted graphic with a new graphic.  
> Calling Context:
 | Called by a tool.  
> Parameters:
 = MGraphic * newFeedback -The new feedback.  
> Return Value:
 | The old feedback.  
> Exceptions:
 | Throws no exceptions, passes all exceptions through.  
> Concurrency:
 | _Not_ multithread safe.  
> Other Considerations:
 | None.  
---------------------------------------------------------------------------
#endif
#if 0
---------------------------------------------------------------------------
> Member Function: TSelectionToolTarget::GetCoordinateView ;
 | TViewHandle GetCoordinateView () const  
> Interface Category:
 | Sample.  
> Purpose:
 | Obtains a reference to the target's coordinate view.  
> Calling Context:
 | Called by a tool.  
> Parameters:
 = Takes no parameters.  
> Return Value:
 | The TViewHandle referencing the target's coordinate view.  
> Exceptions:
 | Throws no exceptions, passes all exceptions through.  
> Concurrency:
 | _Not_ multithread safe.  
> Other Considerations:
 | None.  
---------------------------------------------------------------------------
#endif
#if 0
---------------------------------------------------------------------------
> Member Function: TSelectionToolTarget::GetFeedbacker ;
 | MFeedbacker * GetFeedbacker () const  
> Interface Category:
 | Sample.  
> Purpose:
 | Provides access to the target's feedbacker for derived classes.  
> Calling Context:
 | Called by derived classes.  
> Parameters:
 = Takes no parameters.  
> Return Value:
 | A pointer to the target's feedbacker.  
> Exceptions:
 | Throws no exceptions, passes all exceptions through.  
> Concurrency:
 | _Not_ multithread safe.  
> Other Considerations:
 | None.  
---------------------------------------------------------------------------
#endif
#if 0
---------------------------------------------------------------------------
> Member Function: TSelectionToolTarget::GetMapping ;
 | MSelectionMapping * GetMapping () const  
> Interface Category:
 | Sample.  
> Purpose:
 | Provides access to the targets mapping for derived classes.  
> Calling Context:
 | Called by derived classes.  
> Parameters:
 = Takes no parameters.  
> Return Value:
 | A pointer to the target's mapping.  
> Exceptions:
 | Throws no exceptions, passes all exceptions through.  
> Concurrency:
 | _Not_ multithread safe.  
> Other Considerations:
 | None.  
---------------------------------------------------------------------------
#endif
#if 0
---------------------------------------------------------------------------
> Member Function: TSelectionToolTarget::GetCoordMapping ;
 | const TGrafMatrix * GetCoordMapping () const  
> Interface Category:
 | Sample.  
> Purpose:
 | Constucts a transformation matrix that transforms coordiates from the feedback coordinate system to the mapping coordinate system.  
> Calling Context:
 | Called by derived classes.  
> Parameters:
 = Takes no parameters.  
> Return Value:
 | A transformation matrix that transforms coordiates from the feedback coordinate system to the mapping coordinate system.  
> Exceptions:
 | Throws no exceptions, passes all exceptions through.  
> Concurrency:
 | _Not_ multithread safe.  
> Other Considerations:
 | None.  
---------------------------------------------------------------------------
#endif