// $Revision: 1.5 $
// Copyright (C) 1995 Taligent, Inc. All rights reserved.
#if 0
---------------------------------------------------------------------------
> Class:
 | TSelectionTarget  
> Taxonomy Category:
 | Documented Sample  
 | GlobalSelectionTool  
> Interface Category:
 | Sample.  
> Inherits From:
 | TSelectionToolTarget 
> Inherited By:
 | None. 
> Purpose:
 | Creates a model selection repesenting the data displayed in a specific portion of the screen.  
> 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: TSelectionTarget::TSelectionTarget ;
 | TSelectionTarget (MSelectionMapping * mapping, MFeedbacker * feedbacker)  
> Interface Category:
 | Sample.  
> Purpose:
 | Creates a selection target.  
> Calling Context:
 | Called by the tool handler.  
> Parameters:
 = MSelectionMapping * mapping -The mapping for the target.  
 = MFeedbacker * feedbacker -The feedback for 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: TSelectionTarget::~ TSelectionTarget ;
 | virtual ~ TSelectionTarget ()  
> 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: TSelectionTarget::GetSelectedArea ;
 | TGArea GetSelectedArea () const  
> Interface Category:
 | Sample.  
> Purpose:
 | Returns the area last set by SetSelectedArea.  
> Calling Context:
 | Called by a tool.  
> Parameters:
 = Takes no parameters.  
> Return Value:
 | The area last set by SetSelectedArea.  
> Exceptions:
 | Throws no exceptions, passes all exceptions through.  
> Concurrency:
 | _Not_ multithread safe.  
> Other Considerations:
 | The result of this function is undefined until after the first call to SetSelectedArea.  
---------------------------------------------------------------------------
#endif
#if 0
---------------------------------------------------------------------------
> Member Function: TSelectionTarget::SetSelectedArea ;
 | 1. void SetSelectedArea (const TGPoint & where)  
 | 2. void SetSelectedArea (const TGArea & area)  
> Interface Category:
 | Sample.  
> Purpose:
 | 1. Sets the selected area to a point.  
 | 2. Sets the selected area to an area.  
> Calling Context:
 | 1. Called by a tool to click-select.  
 | 2. Called by a tool to select an area.  
> Parameters:
 = 1. const TGPoint & where -The selected point.  
 = 2. const TGArea & area -The selected area.  
> Return Value:
 | None.  
> Exceptions:
 | Throws no exceptions, passes all exceptions through.  
> Concurrency:
 | _Not_ multithread safe.  
> Other Considerations:
 | None.  
---------------------------------------------------------------------------
#endif
#if 0
---------------------------------------------------------------------------
> Member Function: TSelectionTarget::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