// $Revision: 1.7 $
// Copyright (C) 1995 Taligent, Inc. All rights reserved.
#if 0
---------------------------------------------------------------------------
> Class:
 | TEmptyPickerPresenter  
> Taxonomy Category:
 | Documented Samples  
 | Stock Browser:Picker  
> Interface Category:
 | Sample.  
> Inherits From:
 | TGUIPresenter 
> Inherited By:
 | TStandardPickerPresenter 
> Purpose:
 | Concrete base presenter class for a Stock Picker document component.  
> Instantiation:
 | Always allocate on the heap.  
> Deriving Classes:
 | No special instructions.  
> Concurrency:
 | _Not_ multithread safe.  
> Resource Use:
 | No special requirements.  
> Other Considerations:
 | None.  
---------------------------------------------------------------------------
#endif
#if 0
---------------------------------------------------------------------------
> Member Function: TEmptyPickerPresenter::TEmptyPickerPresenter ;
 | 1. TEmptyPickerPresenter ()  
 | 2. TEmptyPickerPresenter (const TEmptyPickerPresenter & source)  
 | 3. TEmptyPickerPresenter (const TGUIBundle & theBundle)  
> Interface Category:
 | Sample.  
> Purpose:
 | 1. Default constructor.  
 | 2. Copy constructor.  
 | 3. Constructor.  
> Calling Context:
 | 1. Called by derived classes and to construct an object.  
 | 2. Called to copy an object.  
 | 3. Called to construct a valid object.  
> Parameters:
 = 1. Takes no parameters.  
 = 2. const TEmptyPickerPresenter & source -The object to copy.  
 = 3. const TGUIBundle & theBundle -The bundle object needed by many Presentation framework objects.  
> Return Value:
 | None.  
> Exceptions:
 | Throws no exceptions, passes all exceptions through.  
> Concurrency:
 | _Not_ multithread safe.  
> Other Considerations:
 | None.  
---------------------------------------------------------------------------
#endif
#if 0
---------------------------------------------------------------------------
> Member Function: TEmptyPickerPresenter::~ TEmptyPickerPresenter ;
 | virtual ~ TEmptyPickerPresenter ()  
> 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: TEmptyPickerPresenter::operator >>=;
 | virtual TStream & operator >>=(TStream & toStream) const  
> Interface Category:
 | Sample.  
> Purpose:
 | Stream-out operator.  
> Calling Context:
 | Called to stream out data.  
> Parameters:
 = TStream & toStream -The stream the object streams itself out to.  
> Return Value:
 | Returns a reference to the stream the object streams itself out to.  
> Exceptions:
 | Throws no exceptions, passes all exceptions through.  
> Concurrency:
 | _Not_ multithread safe.  
> Other Considerations:
 | None.  
---------------------------------------------------------------------------
#endif
#if 0
---------------------------------------------------------------------------
> Member Function: TEmptyPickerPresenter::operator <<= ;
 | virtual TStream & operator <<= (TStream & fromStream)  
> Interface Category:
 | Sample.  
> Purpose:
 | Stream-in operator.  
> Calling Context:
 | Called to stream in data.  
> Parameters:
 = TStream & fromStream -The stream the object streams itself in from.  
> Return Value:
 | Returns a reference to the stream the object streams itself in from.  
> Exceptions:
 | Throws no exceptions, passes all exceptions through.  
> Concurrency:
 | _Not_ multithread safe.  
> Other Considerations:
 | None.  
---------------------------------------------------------------------------
#endif
#if 0
---------------------------------------------------------------------------
> Member Function: TEmptyPickerPresenter::HandleCreateMainView ;
 | virtual TView * HandleCreateMainView (TGUIBundle * theBundleToAlias) const  
> Interface Category:
 | Sample.  
> Purpose:
 | Creates the main content view for the Stock Picker document component.  
> Calling Context:
 | Called by the Presentation framework.  
> Parameters:
 = TGUIBundle * theBundleToAlias -A pointer to the bundle object needed by many Presentation framework objects.  
> Return Value:
 | A pointer to the newly created view.  
> Exceptions:
 | Throws no exceptions, passes all exceptions through.  
> Concurrency:
 | _Not_ multithread safe.  
> Other Considerations:
 | None.  
---------------------------------------------------------------------------
#endif
#if 0
---------------------------------------------------------------------------
> Member Function: TEmptyPickerPresenter::HandlePrint ;
 | virtual void HandlePrint (const TPrinter & printer) 
> Interface Category:
 | Same as class.
> Purpose:
 | Prints the document. Sets a boolean flag used before printing by HandleCreateMainView and resets it when finished printing.
> Calling Context:
 | Called by the Presentation framework.
> Parameters:
 = const TPrinter & printer - The printer to print the document to.
> Return Value:
 | None.
> Exceptions:
 | Throws no exceptions, passes all exceptions through.
> Concurrency:
 | Same as class.
> Other Considerations:
 | None.
---------------------------------------------------------------------------
#endif

#if 0
---------------------------------------------------------------------------
> Class:
 | TStandardPickerPresenter  
> Taxonomy Category:
 | Documented Samples  
 | Stock Browser:Picker  
> Interface Category:
 | Sample.  
> Inherits From:
 | TEmptyPickerPresenter 
> Inherited By:
 | None. 
> Purpose:
 | A concrete presenter class for the Stock Picker document component. Downloads available stocks from the Stock Server.  
> Instantiation:
 | Always allocate on the heap.  
> Deriving Classes:
 | No special instructions.  
> Concurrency:
 | _Not_ multithread safe.  
> Resource Use:
 | No special requirements.  
> Other Considerations:
 | None.  
---------------------------------------------------------------------------
#endif
#if 0
---------------------------------------------------------------------------
> Member Function: TStandardPickerPresenter::TStandardPickerPresenter ;
 | 1. TStandardPickerPresenter ()  
 | 2. TStandardPickerPresenter (const TStandardPickerPresenter & source)  
 | 3. TStandardPickerPresenter (const TGUIBundle & theBundle)  
> Interface Category:
 | Sample.  
> Purpose:
 | 1. Default constructor.  
 | 2. Copy constructor.  
 | 3. Constructor.  
> Calling Context:
 | 1. Called by derived classes and to construct an object.  
 | 2. Called to copy an object.  
 | 3. Called to construct a valid object.  
> Parameters:
 = 1. Takes no parameters.  
 = 2. const TStandardPickerPresenter & source -The object to copy.  
 = 3. const TGUIBundle & theBundle -A bundle object needed by many Presentation framework classes.  
> Return Value:
 | None.  
> Exceptions:
 | Throws no exceptions, passes all exceptions through.  
> Concurrency:
 | _Not_ multithread safe.  
> Other Considerations:
 | None.  
---------------------------------------------------------------------------
#endif
#if 0
---------------------------------------------------------------------------
> Member Function: TStandardPickerPresenter::~ TStandardPickerPresenter ;
 | virtual ~ TStandardPickerPresenter ()  
> 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: TStandardPickerPresenter::operator >>=;
 | virtual TStream & operator >>=(TStream & toStream) const  
> Interface Category:
 | Sample.  
> Purpose:
 | Stream-out operator.  
> Calling Context:
 | Called to stream out data.  
> Parameters:
 = TStream & toStream -The stream the object streams itself out to.  
> Return Value:
 | Returns a reference to the stream the object streams itself out to.  
> Exceptions:
 | Throws no exceptions, passes all exceptions through.  
> Concurrency:
 | _Not_ multithread safe.  
> Other Considerations:
 | None.  
---------------------------------------------------------------------------
#endif
#if 0
---------------------------------------------------------------------------
> Member Function: TStandardPickerPresenter::operator <<= ;
 | virtual TStream & operator <<= (TStream & fromStream)  
> Interface Category:
 | Sample.  
> Purpose:
 | Stream-in operator.  
> Calling Context:
 | Called to stream in data.  
> Parameters:
 = TStream & fromStream -The stream the object streams itself in from.  
> Return Value:
 | Returns a reference to the stream the object streams itself in from.  
> Exceptions:
 | Throws no exceptions, passes all exceptions through.  
> Concurrency:
 | _Not_ multithread safe.  
> Other Considerations:
 | None.  
---------------------------------------------------------------------------
#endif
#if 0
---------------------------------------------------------------------------
> Member Function: TStandardPickerPresenter::HandleOpen ;
 | virtual void HandleOpen ()  
> Interface Category:
 | Sample.  
> Purpose:
 | Updates the model with available stocks from the Stock Server.  
> Calling Context:
 | Called by the Presentation framework.  
> Parameters:
 = Takes no parameters.  
> Return Value:
 | None.  
> Exceptions:
 | Throws no exceptions. Catches TCompoundDocumentExceptions and passes all others through.  
> Concurrency:
 | _Not_ multithread safe.  
> Other Considerations:
 | None.  
---------------------------------------------------------------------------
#endif