// $Revision: 1.4 $
// Copyright (C) 1995 Taligent, Inc. All rights reserved.
#if 0
---------------------------------------------------------------------------
> Class:
 | TViewerPresenter  
> Taxonomy Category:
 | Documented Samples  
 | Stock Browser  
> Interface Category:
 | Sample.  
> Inherits From:
 | TGUIPresenter 
> Inherited By:
 | None. 
> Purpose:
 | This is the presenter class for the Viewer subproject of Stock Browser.  
> 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: TViewerPresenter::TViewerPresenter ;
 | 1. TViewerPresenter ()  
 | 2. TViewerPresenter (const TViewerPresenter & source)  
 | 3. TViewerPresenter (const TGUIBundle & guiBundle)  
> Interface Category:
 | Sample.  
> Purpose:
 | 1. Default constructor.  
 | 2. Copy constructor.  
 | 3. Standard constructor.  
> Calling Context:
 | 1. Called by the stream-in operators and derived classes.  
 | 2. Called to copy an object.  
 | 3. Called to construct a valid object.  
> Parameters:
 = 1. Takes no parameters.  
 = 2. const TViewerPresenter & source -The object to copy.  
 = 3. const TGUIBundle & guiBundle -An object needed by many classes in the Presentation framework.  
> Return Value:
 | None.  
> Exceptions:
 | Throws no exceptions, passes all exceptions through.  
> Concurrency:
 | _Not_ multithread safe.  
> Other Considerations:
 | None.  
---------------------------------------------------------------------------
#endif
#if 0
---------------------------------------------------------------------------
> Member Function: TViewerPresenter::~ TViewerPresenter ;
 | virtual ~ TViewerPresenter ()  
> 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: TViewerPresenter::HandleCreateMainView ;
 | virtual TView * HandleCreateMainView (TGUIBundle * bundleToAlias) const  
> Interface Category:
 | Sample.  
> Purpose:
 | Creates the main content view for the document window. This function creates a TViewerContentView object and passes it the bundle pointer.  
> Calling Context:
 | Called by the Presentation framework.  
> Parameters:
 = TGUIBundle * bundleToAlias -A pointer to a bundle object needed by many classes in the Presentation framework.  
> Return Value:
 | A pointer to the newly created content view.  
> Exceptions:
 | Throws no exceptions, passes all exceptions through.  
> Concurrency:
 | _Not_ multithread safe.  
> Other Considerations:
 | None.  
---------------------------------------------------------------------------
#endif
#if 0
---------------------------------------------------------------------------
> Member Function: TViewerPresenter::HandleMenuActivate ;
 | virtual void HandleMenuActivate (TMenu & theMainMenu)  
> Interface Category:
 | Sample.  
> Purpose:
 | Adds a View menu to the global menu palette.  
> Calling Context:
 | Called by the Presentation framework.  
> Parameters:
 = TMenu & theMainMenu -The global menu to add the View menu to.  
> Return Value:
 | None.  
> Exceptions:
 | Throws no exceptions, passes all exceptions through.  
> Concurrency:
 | _Not_ multithread safe.  
> Other Considerations:
 | None.  
---------------------------------------------------------------------------
#endif
#if 0
---------------------------------------------------------------------------
> Member Function: TViewerPresenter::HandleMenuDeactivate ;
 | virtual void HandleMenuDeactivate (TMenu & theMainMenu)  
> Interface Category:
 | Sample.  
> Purpose:
 | Removes the View menu from the global menu palette.  
> Calling Context:
 | Called by the Presentation framework.  
> Parameters:
 = TMenu & theMainMenu -The global menu from which to remove the View menu.  
> Return Value:
 | None.  
> Exceptions:
 | Throws no exceptions, passes all exceptions through.  
> Concurrency:
 | _Not_ multithread safe.  
> Other Considerations:
 | None.  
---------------------------------------------------------------------------
#endif
#if 0
---------------------------------------------------------------------------
> Member Function: TViewerPresenter::CreateViewSubMenuItem ;
 | virtual TSubMenuItem * CreateViewSubMenuItem () const  
> Interface Category:
 | Sample.  
> Purpose:
 | Creates the View menu.  
> Calling Context:
 | Called by HandleMenuActivate if the View menu hasn't yet been created and initialized.  
> Parameters:
 = Takes no parameters.  
> Return Value:
 | A pointer to an object that can be installed as a submenu in another menu.  
> Exceptions:
 | Throws no exceptions, passes all exceptions through.  
> Concurrency:
 | _Not_ multithread safe.  
> Other Considerations:
 | Derived classes can override this function to add new graph constructors to the View menu, or to retrieve them from a different location, such as an archive.  
---------------------------------------------------------------------------
#endif
#if 0
---------------------------------------------------------------------------
> Member Function: TViewerPresenter::CreateStandardGraph ;
 | virtual TStandardGraph * CreateStandardGraph () const  
> Interface Category:
 | Sample.  
> Purpose:
 | Creates a graph object.  
> Calling Context:
 | Called by this class to create an empty graph into which stock data will be drawn.  
> Parameters:
 = Takes no parameters.  
> Return Value:
 | A pointer to a graph object.  
> Exceptions:
 | Throws no exceptions, passes all exceptions through.  
> Concurrency:
 | _Not_ multithread safe.  
> Other Considerations:
 | None.  
---------------------------------------------------------------------------
#endif
#if 0
---------------------------------------------------------------------------
> Member Function: TViewerPresenter::CreateCollectionOfGraphConstructors ;
 | virtual TCollectionOf < TStockGraphConstructor > * CreateCollectionOfGraphConstructors () const
> Interface Category:
 | Sample.  
> Purpose:
 | Creates the collection of available graph constructor objects. The user selects among these to view the stock data in different ways.  
> Calling Context:
 | Called by CreateViewSubMenuItem in order to install available graph constructors in the View menu.  
> Parameters:
 = Takes no parameters.  
> Return Value:
 | A pointer to a collection containing available graph constructors.  
> Exceptions:
 | Throws no exceptions, passes all exceptions through.  
> Concurrency:
 | _Not_ multithread safe.  
> Other Considerations:
 | None.  
---------------------------------------------------------------------------
#endif