// $Revision: 1.4 $
// Copyright (C) 1995 Taligent, Inc. All rights reserved.
#if 0
---------------------------------------------------------------------------
> Class:
 | TPriceGraphConstructor  
> Taxonomy Category:
 | Documented Samples  
 | Stock Browser  
> Interface Category:
 | Sample.  
> Inherits From:
 | TStockGraphConstructor 
> Inherited By:
 | TAllDaysPriceGraphConstructor 
 | TMonthlySummaryPriceGraphConstructor 
 | TWeeklySummaryPriceGraphConstructor 
> Purpose:
 | An abstract base class that provides some price-graph constructing behavior.  
> Instantiation:
 | Allocate on the heap or the stack.  
> Deriving Classes:
 | No special instructions.  
> Concurrency:
 | _Not_ multithread safe.  
> Resource Use:
 | No special requirements.  
> Other Considerations:
 | None.  
---------------------------------------------------------------------------
#endif
#if 0
---------------------------------------------------------------------------
> Member Function: TPriceGraphConstructor::TPriceGraphConstructor ;
 | 1. TPriceGraphConstructor (const TStandardText & description, const TStandardText & xAxisLabel, const TStandardText & yAxisLabel)  
 | 2. TPriceGraphConstructor (const TPriceGraphConstructor & source)  
 | 3. TPriceGraphConstructor ()  
> Interface Category:
 | Sample.  
> Purpose:
 | 1. Standard constructor.  
 | 2. Copy constructor.  
 | 3. Default constructor.  
> Calling Context:
 | 1. Called to construct a valid object.  
 | 2. Called to copy an object.  
 | 3. Called by derived classes and to construct an object.  
> Parameters:
 = 1. const TStandardText & description -A description of the action performed by this object. See TStockGraphConstructor.  
 = 1. const TStandardText & xAxisLabel -The label to display in the graph for the x-axis.  
 = 1. const TStandardText & yAxisLabel -The label to display in the graph for the y-axis.  
 = 2. const TPriceGraphConstructor & source -The object to copy.  
 = 3. 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: TPriceGraphConstructor::~ TPriceGraphConstructor ;
 | virtual ~ TPriceGraphConstructor ()  
> 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: TPriceGraphConstructor::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: TPriceGraphConstructor::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: TPriceGraphConstructor::CalcGraphRanges ;
 | virtual void CalcGraphRanges (TGraphRange & xRange, TGraphRange & yRange, const TCollectionOf < TStockDay > & data) 
> Interface Category:
 | Sample.  
> Purpose:
 | Examines the set of stock data and determines the extent of the data --that is, the actual ranges of the data for both the x-axis and y-axis.  
> Calling Context:
 | Called by TStockGraphConstructor::Do when this object is called upon to construct a graph.  
> Parameters:
 = TGraphRange & xRange -The modifiable x-axis range.  
 = TGraphRange & yRange -The modifiable y-axis range.  
 = const TCollectionOf < TStockDay > & data - The collection of stock data.
> Return Value:
 | None.  
> Exceptions:
 | Throws no exceptions, passes all exceptions through.  
> Concurrency:
 | _Not_ multithread safe.  
> Other Considerations:
 | None.  
---------------------------------------------------------------------------
#endif
#if 0
---------------------------------------------------------------------------
> Member Function: TPriceGraphConstructor::HandleAddExtendedDrawers ;
 | virtual void HandleAddExtendedDrawers (TStandardGraph & theGraph, const TCollectionOf < TStockDay > & data, const TGraphRange & xRange, const TGraphRange & yRange) 
> Interface Category:
 | Sample.  
> Purpose:
 | Adds drawer objects specific to the type of graph being constructed.  
> Calling Context:
 | Called by TStockGraphConstructor::Do when this object is called upon to construct a graph.  
> Parameters:
 = TStandardGraph & theGraph -The graph to add drawer objects to.  
 = const TCollectionOf < TStockDay > & data - The collection of stock data the drawers must plot on the graph.
 = const TGraphRange & xRange -The range of values to graph on the x-axis.  
 = const TGraphRange & yRange -The range of values to graph on the y-axis.  
> Return Value:
 | None.  
> Exceptions:
 | Throws no exceptions, passes all exceptions through.  
> Concurrency:
 | _Not_ multithread safe.  
> Other Considerations:
 | None.  
---------------------------------------------------------------------------
#endif
#if 0
---------------------------------------------------------------------------
> Member Function: TPriceGraphConstructor::HandleDoEnd ;
 | virtual void HandleDoEnd (TStandardGraph & theGraph, const TCollectionOf < TStockDay > & data, const TGraphRange & xRange, const TGraphRange & yRange) 
> Interface Category:
 | Sample.  
> Purpose:
 | A hook function for post-processing the graph, after drawers have been added. For instance, you can set the size of the graph in this function.  
> Calling Context:
 | Called by TStockGraphConstructor::Do when this object is called upon to construct a graph.  
> Parameters:
 = TStandardGraph & theGraph -The graph to modify.  
 = const TCollectionOf < TStockDay > & data - The collection of stock data that is to be graphed.
 = const TGraphRange & xRange -The range of values to graph on the x-axis.  
 = const TGraphRange & yRange -The range of values to graph on the y-axis.  
> Return Value:
 | None.  
> Exceptions:
 | Throws no exceptions, passes all exceptions through.  
> Concurrency:
 | _Not_ multithread safe.  
> Other Considerations:
 | None.  
---------------------------------------------------------------------------
#endif
#if 0
---------------------------------------------------------------------------
> Class:
 | TAllDaysPriceGraphConstructor  
> Taxonomy Category:
 | Documented Samples  
 | Stock Browser  
> Interface Category:
 | Sample.  
> Inherits From:
 | TPriceGraphConstructor 
> Inherited By:
 | None. 
> Purpose:
 | Constructs a graph (sets up drawers for it) to display stock price information for each day separately.  
> Instantiation:
 | Allocate on the heap or the stack.  
> Deriving Classes:
 | No special instructions.  
> Concurrency:
 | _Not_ multithread safe.  
> Resource Use:
 | No special requirements.  
> Other Considerations:
 | None.  
---------------------------------------------------------------------------
#endif
#if 0
---------------------------------------------------------------------------
> Member Function: TAllDaysPriceGraphConstructor::TAllDaysPriceGraphConstructor ;
 | 1. TAllDaysPriceGraphConstructor (const TStandardText & description, const TStandardText & xAxisLabel, const TStandardText & yAxisLabel)  
 | 2. TAllDaysPriceGraphConstructor (const TAllDaysPriceGraphConstructor & source)  
 | 3. TAllDaysPriceGraphConstructor ()  
> Interface Category:
 | Sample.  
> Purpose:
 | 1. Standard constructor.  
 | 2. Copy constructor.  
 | 3. Default constructor.  
> Calling Context:
 | 1. Called to construct a valid object.  
 | 2. Called to copy an object.  
 | 3. Called by derived classes and to construct an object.  
> Parameters:
 = 1. const TStandardText & description -The description of the action taken by this object. See TStockGraphGraphConstructor.  
 = 1. const TStandardText & xAxisLabel -The label to display in the graph for the x-axis.  
 = 1. const TStandardText & yAxisLabel -The label to display in the graph for the y-axis.  
 = 2. const TAllDaysPriceGraphConstructor & source -The object to copy.  
 = 3. 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: TAllDaysPriceGraphConstructor::~ TAllDaysPriceGraphConstructor ;
 | virtual ~ TAllDaysPriceGraphConstructor ()  
> 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: TAllDaysPriceGraphConstructor::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: TAllDaysPriceGraphConstructor::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: TAllDaysPriceGraphConstructor::HandleDoBegin ;
 | virtual void HandleDoBegin (TStandardGraph & theGraph, TCollectionOf < TStockDay > & data) 
> Interface Category:
 | Sample.  
> Purpose:
 | A hook function to allow some preprocessing of the graph and data, before drawers are added or graph ranges are calculated.  
> Calling Context:
 | Called by TStockGraphConstructor::Do when this object is called upon to construct a graph.  
> Parameters:
 = TStandardGraph & theGraph -The graph to modify.  
 = TCollectionOf < TStockDay > & data - The modifiable stock data.
> Return Value:
 | None.  
> Exceptions:
 | Throws no exceptions, passes all exceptions through.  
> Concurrency:
 | _Not_ multithread safe.  
> Other Considerations:
 | None.  
---------------------------------------------------------------------------
#endif
#if 0
---------------------------------------------------------------------------
> Class:
 | TMonthlySummaryPriceGraphConstructor  
> Taxonomy Category:
 | Documented Samples  
 | Stock Browser  
> Interface Category:
 | Sample.  
> Inherits From:
 | TPriceGraphConstructor 
> Inherited By:
 | None. 
> Purpose:
 | Constructs a graph (sets up drawers for it) to display stock price information grouped by month.  
> Instantiation:
 | Allocate on the heap or the stack.  
> Deriving Classes:
 | No special instructions.  
> Concurrency:
 | _Not_ multithread safe.  
> Resource Use:
 | No special requirements.  
> Other Considerations:
 | None.  
---------------------------------------------------------------------------
#endif
#if 0
---------------------------------------------------------------------------
> Member Function: TMonthlySummaryPriceGraphConstructor::TMonthlySummaryPriceGraphConstructor ;
 | 1. TMonthlySummaryPriceGraphConstructor (const TStandardText & description, const TStandardText & xAxisLabel, const TStandardText & yAxisLabel)  
 | 2. TMonthlySummaryPriceGraphConstructor (const TMonthlySummaryPriceGraphConstructor & source)  
 | 3. TMonthlySummaryPriceGraphConstructor ()  
> Interface Category:
 | Sample.  
> Purpose:
 | 1. Standard constructor.  
 | 2. Copy constructor.  
 | 3. Default constructor.  
> Calling Context:
 | 1. Called to construct a valid object.  
 | 2. Called to copy an object.  
 | 3. Called by derived classes and to construct an object.  
> Parameters:
 = 1. const TStandardText & description -A description of the action taken by this object. See TStockGraphGraphConstructor.  
 = 1. const TStandardText & xAxisLabel -The label to display in the graph for the x-axis.  
 = 1. const TStandardText & yAxisLabel -The label to display in the graph for the y-axis.  
 = 2. const TMonthlySummaryPriceGraphConstructor & source -The object to copy.  
 = 3. 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: TMonthlySummaryPriceGraphConstructor::~ TMonthlySummaryPriceGraphConstructor ;
 | virtual ~ TMonthlySummaryPriceGraphConstructor ()  
> 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: TMonthlySummaryPriceGraphConstructor::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: TMonthlySummaryPriceGraphConstructor::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: TMonthlySummaryPriceGraphConstructor::HandleDoBegin ;
 | virtual void HandleDoBegin (TStandardGraph & theGraph, TCollectionOf < TStockDay > & data) 
> Interface Category:
 | Sample.  
> Purpose:
 | A hook function to allow some preprocessing of the graph and data, before drawers are added or graph ranges are calculated.  
> Calling Context:
 | Called by TStockGraphConstructor::Do when this object is called upon to construct a graph.  
> Parameters:
 = TStandardGraph & theGraph -The graph to modify.  
 = TCollectionOf < TStockDay > & data - The modifiable stock data.
> Return Value:
 | None.  
> Exceptions:
 | Throws no exceptions, passes all exceptions through.  
> Concurrency:
 | _Not_ multithread safe.  
> Other Considerations:
 | None.  
---------------------------------------------------------------------------
#endif
#if 0
---------------------------------------------------------------------------
> Class:
 | TWeeklySummaryPriceGraphConstructor  
> Taxonomy Category:
 | Documented Samples  
 | Stock Browser  
> Interface Category:
 | Sample.  
> Inherits From:
 | TPriceGraphConstructor 
> Inherited By:
 | None. 
> Purpose:
 | Constructs a graph (sets up drawers for it) to display stock price information grouped by week.  
> Instantiation:
 | Allocate on the heap or the stack.  
> Deriving Classes:
 | No special instructions.  
> Concurrency:
 | _Not_ multithread safe.  
> Resource Use:
 | No special requirements.  
> Other Considerations:
 | None.  
---------------------------------------------------------------------------
#endif
#if 0
---------------------------------------------------------------------------
> Member Function: TWeeklySummaryPriceGraphConstructor::TWeeklySummaryPriceGraphConstructor ;
 | 1. TWeeklySummaryPriceGraphConstructor (const TStandardText & description, const TStandardText & xAxisLabel, const TStandardText & yAxisLabel)  
 | 2. TWeeklySummaryPriceGraphConstructor (const TWeeklySummaryPriceGraphConstructor & source)  
 | 3. TWeeklySummaryPriceGraphConstructor ()  
> Interface Category:
 | Sample.  
> Purpose:
 | 1. Standard constructor.  
 | 2. Copy constructor.  
 | 3. Default constructor.  
> Calling Context:
 | 1. Called to construct a valid object.  
 | 2. Called to copy an object.  
 | 3. Called by derived classes and to construct an object.  
> Parameters:
 = 1. const TStandardText & description -A description of the action taken by this object. See TStockGraphGraphConstructor.  
 = 1. const TStandardText & xAxisLabel -The label to display in the graph for the x-axis.  
 = 1. const TStandardText & yAxisLabel -The label to display in the graph for the y-axis.  
 = 2. const TWeeklySummaryPriceGraphConstructor & source -The object to copy.  
 = 3. 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: TWeeklySummaryPriceGraphConstructor::~ TWeeklySummaryPriceGraphConstructor ;
 | virtual ~ TWeeklySummaryPriceGraphConstructor ()  
> 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: TWeeklySummaryPriceGraphConstructor::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: TWeeklySummaryPriceGraphConstructor::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: TWeeklySummaryPriceGraphConstructor::HandleDoBegin ;
 | virtual void HandleDoBegin (TStandardGraph & theGraph, TCollectionOf < TStockDay > & data) 
> Interface Category:
 | Sample.  
> Purpose:
 | A hook function to allow some preprocessing of the graph and data, before drawers are added or graph ranges are calculated.  
> Calling Context:
 | Called by TStockGraphConstructor::Do when this object is called upon to construct a graph.  
> Parameters:
 = TStandardGraph & theGraph -The graph to modify.  
 = TCollectionOf < TStockDay > & data - The modifiable stock data.
> Return Value:
 | None.  
> Exceptions:
 | Throws no exceptions, passes all exceptions through.  
> Concurrency:
 | _Not_ multithread safe.  
> Other Considerations:
 | None.  
---------------------------------------------------------------------------
#endif
#if 0
---------------------------------------------------------------------------
> Class:
 | TVolumeGraphConstructor  
> Taxonomy Category:
 | Documented Samples  
 | Stock Browser  
> Interface Category:
 | Sample.  
> Inherits From:
 | TStockGraphConstructor 
> Inherited By:
 | TAllDaysVolumeGraphConstructor 
 | TMonthlySummaryVolumeGraphConstructor 
 | TWeeklySummaryVolumeGraphConstructor 
> Purpose:
 | An abstract base class that provides some volume-graph constructing behavior.  
> Instantiation:
 | Allocate on the heap or the stack.  
> Deriving Classes:
 | No special instructions.  
> Concurrency:
 | _Not_ multithread safe.  
> Resource Use:
 | No special requirements.  
> Other Considerations:
 | None.  
---------------------------------------------------------------------------
#endif
#if 0
---------------------------------------------------------------------------
> Member Function: TVolumeGraphConstructor::TVolumeGraphConstructor ;
 | 1. TVolumeGraphConstructor (const TStandardText & description, const TStandardText & xAxisLabel, const TStandardText & yAxisLabel)  
 | 2. TVolumeGraphConstructor (const TVolumeGraphConstructor & source)  
 | 3. TVolumeGraphConstructor ()  
> Interface Category:
 | Sample.  
> Purpose:
 | 1. Standard constructor.  
 | 2. Copy constructor.  
 | 3. Default constructor.  
> Calling Context:
 | 1. Called to construct a valid object.  
 | 2. Called to copy an object.  
 | 3. Called by derived classes and to construct an object.  
> Parameters:
 = 1. const TStandardText & description -A description of the action taken by this object. See TStockGraphConstructor.  
 = 1. const TStandardText & xAxisLabel -The label to display in the graph for the x-axis.  
 = 1. const TStandardText & yAxisLabel -The label to display in the graph for the y-axis.  
 = 2. const TVolumeGraphConstructor & source -The object to copy.  
 = 3. 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: TVolumeGraphConstructor::~ TVolumeGraphConstructor ;
 | virtual ~ TVolumeGraphConstructor ()  
> 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: TVolumeGraphConstructor::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: TVolumeGraphConstructor::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: TVolumeGraphConstructor::CalcGraphRanges ;
 | virtual void CalcGraphRanges (TGraphRange & xRange, TGraphRange & yRange, const TCollectionOf < TStockDay > & data) 
> Interface Category:
 | Sample.  
> Purpose:
 | Examines the set of stock data and determines the extent of the data --that is, the actual ranges of the data for both the x-axis and y-axis.  
> Calling Context:
 | Called by TStockGraphConstructor::Do when this object is called upon to construct a graph.  
> Parameters:
 = TGraphRange & xRange -The modifiable x-axis range.  
 = TGraphRange & yRange -The modifiable y-axis range.  
 = const TCollectionOf < TStockDay > & data - The collection of stock data.
> Return Value:
 | None.  
> Exceptions:
 | Throws no exceptions, passes all exceptions through.  
> Concurrency:
 | _Not_ multithread safe.  
> Other Considerations:
 | None.  
---------------------------------------------------------------------------
#endif
#if 0
---------------------------------------------------------------------------
> Member Function: TVolumeGraphConstructor::HandleAddExtendedDrawers ;
 | virtual void HandleAddExtendedDrawers (TStandardGraph & theGraph, const TCollectionOf < TStockDay > & data, const TGraphRange & xRange, const TGraphRange & yRange) 
> Interface Category:
 | Sample.  
> Purpose:
 | Adds drawer objects specific to the type of graph being constructed.  
> Calling Context:
 | Called by TStockGraphConstructor::Do when this object is called upon to construct a graph.  
> Parameters:
 = TStandardGraph & theGraph -The graph to add drawer objects to.  
 = const TCollectionOf < TStockDay > & data - The collection of stock data the drawers must plot on the graph.
 = const TGraphRange & xRange -The range of values to graph on the x-axis.  
 = const TGraphRange & yRange -The range of values to graph on the y-axis.  
> Return Value:
 | None.  
> Exceptions:
 | Throws no exceptions, passes all exceptions through.  
> Concurrency:
 | _Not_ multithread safe.  
> Other Considerations:
 | None.  
---------------------------------------------------------------------------
#endif
#if 0
---------------------------------------------------------------------------
> Member Function: TVolumeGraphConstructor::HandleDoEnd ;
 | virtual void HandleDoEnd (TStandardGraph & theGraph, const TCollectionOf < TStockDay > & data, const TGraphRange & xRange, const TGraphRange & yRange) 
> Interface Category:
 | Sample.  
> Purpose:
 | A hook function for postprocessing the graph, after drawers have been added. For instance, you can set the size of the graph in this function.  
> Calling Context:
 | Called by TStockGraphConstructor::Do when this object is called upon to construct a graph.  
> Parameters:
 = TStandardGraph & theGraph -The graph to modify.  
 = const TCollectionOf < TStockDay > & data - The collection of stock data that is to be graphed.
 = const TGraphRange & xRange -The range of values to graph on the x-axis.  
 = const TGraphRange & yRange -The range of values to graph on the y-axis.  
> Return Value:
 | None.  
> Exceptions:
 | Throws no exceptions, passes all exceptions through.  
> Concurrency:
 | _Not_ multithread safe.  
> Other Considerations:
 | None.  
---------------------------------------------------------------------------
#endif
#if 0
---------------------------------------------------------------------------
> Class:
 | TAllDaysVolumeGraphConstructor  
> Taxonomy Category:
 | Documented Samples  
 | Stock Browser  
> Interface Category:
 | Sample.  
> Inherits From:
 | TVolumeGraphConstructor 
> Inherited By:
 | None. 
> Purpose:
 | Constructs a graph (sets up drawers for it) to display stock volume information for each day separately.  
> Instantiation:
 | Allocate on the heap or the stack.  
> Deriving Classes:
 | No special instructions.  
> Concurrency:
 | _Not_ multithread safe.  
> Resource Use:
 | No special requirements.  
> Other Considerations:
 | None.  
---------------------------------------------------------------------------
#endif
#if 0
---------------------------------------------------------------------------
> Member Function: TAllDaysVolumeGraphConstructor::TAllDaysVolumeGraphConstructor ;
 | 1. TAllDaysVolumeGraphConstructor (const TStandardText & description, const TStandardText & xAxisLabel, const TStandardText & yAxisLabel)  
 | 2. TAllDaysVolumeGraphConstructor (const TAllDaysVolumeGraphConstructor & source)  
 | 3. TAllDaysVolumeGraphConstructor ()  
> Interface Category:
 | Sample.  
> Purpose:
 | 1. Standard constructor.  
 | 2. Copy constructor.  
 | 3. Default constructor.  
> Calling Context:
 | 1. Called to construct a valid object.  
 | 2. Called to copy an object.  
 | 3. Called by derived classes an to construct an object.  
> Parameters:
 = 1. const TStandardText & description -The description of the action taken by this object. See TStockGraphGraphConstructor.  
 = 1. const TStandardText & xAxisLabel -The label to display in the graph for the x-axis.  
 = 1. const TStandardText & yAxisLabel -The label to display in the graph for the y-axis.  
 = 2. const TAllDaysVolumeGraphConstructor & source -The object to copy.  
 = 3. 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: TAllDaysVolumeGraphConstructor::~ TAllDaysVolumeGraphConstructor ;
 | virtual ~ TAllDaysVolumeGraphConstructor ()  
> 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: TAllDaysVolumeGraphConstructor::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: TAllDaysVolumeGraphConstructor::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: TAllDaysVolumeGraphConstructor::HandleDoBegin ;
 | virtual void HandleDoBegin (TStandardGraph & theGraph, TCollectionOf < TStockDay > & data) 
> Interface Category:
 | Sample.  
> Purpose:
 | A hook function to allow some preprocessing of the graph and data, before drawers are added or graph ranges are calculated.  
> Calling Context:
 | Called by TStockGraphConstructor::Do when this object is called upon to construct a graph.  
> Parameters:
 = TStandardGraph & theGraph -The graph to modify.  
 = TCollectionOf < TStockDay > & data - The modifiable stock data.
> Return Value:
 | None.  
> Exceptions:
 | Throws no exceptions, passes all exceptions through.  
> Concurrency:
 | _Not_ multithread safe.  
> Other Considerations:
 | None.  
---------------------------------------------------------------------------
#endif
#if 0
---------------------------------------------------------------------------
> Class:
 | TMonthlySummaryVolumeGraphConstructor  
> Taxonomy Category:
 | Documented Samples  
 | Stock Browser  
> Interface Category:
 | Sample.  
> Inherits From:
 | TVolumeGraphConstructor 
> Inherited By:
 | None. 
> Purpose:
 | Constructs a graph (sets up drawers for it) to display stock volume information grouped by month.  
> Instantiation:
 | Allocate on the heap or the stack.  
> Deriving Classes:
 | No special instructions.  
> Concurrency:
 | _Not_ multithread safe.  
> Resource Use:
 | No special requirements.  
> Other Considerations:
 | None.  
---------------------------------------------------------------------------
#endif
#if 0
---------------------------------------------------------------------------
> Member Function: TMonthlySummaryVolumeGraphConstructor::TMonthlySummaryVolumeGraphConstructor ;
 | 1. TMonthlySummaryVolumeGraphConstructor (const TStandardText & description, const TStandardText & xAxisLabel, const TStandardText & yAxisLabel)  
 | 2. TMonthlySummaryVolumeGraphConstructor (const TMonthlySummaryVolumeGraphConstructor & source)  
 | 3. TMonthlySummaryVolumeGraphConstructor ()  
> Interface Category:
 | Sample.  
> Purpose:
 | 1. Standard constructor.  
 | 2. Copy constructor.  
 | 3. Default constructor.  
> Calling Context:
 | 1. Called to construct a valid object.  
 | 2. Called to copy an object.  
 | 3. Called by derived classes and to construct an object.  
> Parameters:
 = 1. const TStandardText & description -A short description of the action to be taken by this object. See TStockGraphGraphConstructor.  
 = 1. const TStandardText & xAxisLabel -The label to display in the graph for the x-axis.  
 = 1. const TStandardText & yAxisLabel -The label to display in the graph for the y-axis.  
 = 2. const TMonthlySummaryVolumeGraphConstructor & source -The object to copy.  
 = 3. 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: TMonthlySummaryVolumeGraphConstructor::~ TMonthlySummaryVolumeGraphConstructor ;
 | virtual ~ TMonthlySummaryVolumeGraphConstructor ()  
> 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: TMonthlySummaryVolumeGraphConstructor::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: TMonthlySummaryVolumeGraphConstructor::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: TMonthlySummaryVolumeGraphConstructor::HandleDoBegin ;
 | virtual void HandleDoBegin (TStandardGraph & theGraph, TCollectionOf < TStockDay > & data) 
> Interface Category:
 | Sample.  
> Purpose:
 | A hook function to allow some preprocessing of the graph and data, before drawers are added or graph ranges are calculated.  
> Calling Context:
 | Called by TStockGraphConstructor::Do when this object is called upon to construct a graph.  
> Parameters:
 = TStandardGraph & theGraph -The graph to modify.  
 = TCollectionOf < TStockDay > & data - The modifiable stock data.
> Return Value:
 | None.  
> Exceptions:
 | Throws no exceptions, passes all exceptions through.  
> Concurrency:
 | _Not_ multithread safe.  
> Other Considerations:
 | None.  
---------------------------------------------------------------------------
#endif
#if 0
---------------------------------------------------------------------------
> Class:
 | TWeeklySummaryVolumeGraphConstructor  
> Taxonomy Category:
 | Documented Samples  
 | Stock Browser  
> Interface Category:
 | Sample.  
> Inherits From:
 | TVolumeGraphConstructor 
> Inherited By:
 | None. 
> Purpose:
 | Constructs a graph (sets up drawers for it) to display stock volume information grouped by week.  
> Instantiation:
 | Allocate on the heap or the stack.  
> Deriving Classes:
 | No special instructions.  
> Concurrency:
 | _Not_ multithread safe.  
> Resource Use:
 | No special requirements.  
> Other Considerations:
 | None.  
---------------------------------------------------------------------------
#endif
#if 0
---------------------------------------------------------------------------
> Member Function: TWeeklySummaryVolumeGraphConstructor::TWeeklySummaryVolumeGraphConstructor ;
 | 1. TWeeklySummaryVolumeGraphConstructor (const TStandardText & description, const TStandardText & xAxisLabel, const TStandardText & yAxisLabel)  
 | 2. TWeeklySummaryVolumeGraphConstructor (const TWeeklySummaryVolumeGraphConstructor & source)  
 | 3. TWeeklySummaryVolumeGraphConstructor ()  
> Interface Category:
 | Sample.  
> Purpose:
 | 1. Standard constructor.  
 | 2. Copy constructor.  
 | 3. Default constructor.  
> Calling Context:
 | 1. Called to construct a valid object.  
 | 2. Called to copy an object.  
 | 3. Called by derived classes and to construct an object.  
> Parameters:
 = 1. const TStandardText & description -A description of the action taken by this object. See TStockGraphGraphConstructor.  
 = 1. const TStandardText & xAxisLabel -The label to display in the graph for the x-axis.  
 = 1. const TStandardText & yAxisLabel -The label to display in the graph for the y-axis.  
 = 2. const TWeeklySummaryVolumeGraphConstructor & source -The object to copy.  
 = 3. 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: TWeeklySummaryVolumeGraphConstructor::~ TWeeklySummaryVolumeGraphConstructor ;
 | virtual ~ TWeeklySummaryVolumeGraphConstructor ()  
> 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: TWeeklySummaryVolumeGraphConstructor::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: TWeeklySummaryVolumeGraphConstructor::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: TWeeklySummaryVolumeGraphConstructor::HandleDoBegin ;
 | virtual void HandleDoBegin (TStandardGraph & theGraph, TCollectionOf < TStockDay > & data) 
> Interface Category:
 | Sample.  
> Purpose:
 | A hook function to allow some preprocessing of the graph and data, before drawers are added or graph ranges are calculated.  
> Calling Context:
 | Called by TStockGraphConstructor::Do when this object is called upon to construct a graph.  
> Parameters:
 = TStandardGraph & theGraph -The graph to modify.  
 = TCollectionOf < TStockDay > & data - The modifiable stock data.
> Return Value:
 | None.  
> Exceptions:
 | Throws no exceptions, passes all exceptions through.  
> Concurrency:
 | _Not_ multithread safe.  
> Other Considerations:
 | None.  
---------------------------------------------------------------------------
#endif