rwlogo
Rogue Wave Views 5.6

Rogue Wave Views
Charts Package API Reference Guide

Product Documentation:

Rogue Wave Views
Documentation Home

IlvChartDataListener Class Reference

Abstract base class for chart data object listeners. More...

#include <ilviews/charts/data.h>

Inherited by IlvChartGraphicDataListener.

List of all members.

Public Member Functions

virtual void dataAllPointsRemoved (const IlvAbstractChartData *cData, const IlvChartDataSet *dataSet)
 Performs the necessary updates when all data points are removed.
virtual void dataPointAdded (const IlvAbstractChartData *cData, const IlvChartDataSet *dataSet, IlUInt position)
 Performs the necessary updates when a data point is added.
virtual void dataPointChanged (const IlvAbstractChartData *cData, const IlvChartDataSet *dataSet, IlUInt ptidx, IlBoolean beforeChange)
 Performs the necessary updates when a data point is changed.
virtual void dataPointRemoved (const IlvAbstractChartData *cData, const IlvChartDataSet *dataSet, IlUInt ptidx)
 Performs the necessary updates when a data point is removed.
virtual void dataSetAdded (const IlvAbstractChartData *cData, IlvChartDataSet *dataSet, IlUInt position)
 Performs the necessary updates when a data set is added.
virtual void dataSetChanged (const IlvAbstractChartData *cData, IlvChartDataSet *oldSet, IlvChartDataSet *newSet)
 Performs the necessary updates when a data set is changed.
virtual void dataSetRemoved (const IlvAbstractChartData *cData, IlvChartDataSet *dataSet)
 Performs the necessary updates when a data set is removed.
virtual void endBatch (const IlvAbstractChartData *cData, const IlvChartDataSet *dataSet)
 Specifies the end of a set of modifications on a data set.
virtual void startBatch (const IlvAbstractChartData *cData, const IlvChartDataSet *dataSet)
 Specifies the beginning of a set of modifications on a data set.

Protected Member Functions

 IlvChartDataListener ()
 Constructor.

Detailed Description

Abstract base class for chart data object listeners.

Library: ilvcharts

This class is the main class used to propagate all modifications made to an IlvAbstractChartData object (or one of its derived objects) to a given object that uses it. Such is the case for all the chart graphics that use it to manage the data sets they display.

This class must be subclassed in order to specify the object to which the modifications must be propagated and to implement the changes that must be applied to the object when the IlvAbstractChartData object (or one of its derived objects) is modified. For this reason, the constructor of this class is defined as protected an instance of the class is never created directly.

See also:
IlvAbstractChartData.

Constructor & Destructor Documentation

IlvChartDataListener::IlvChartDataListener (  )  [protected]

Constructor.

Initializes a new IlvChartDataListener object.


Member Function Documentation

virtual void IlvChartDataListener::dataAllPointsRemoved ( const IlvAbstractChartData cData,
const IlvChartDataSet dataSet 
) [virtual]

Performs the necessary updates when all data points are removed.

Performs the necessary updates to the object that uses an IlvAbstractChartData object (or one of its derived objects) when all data points are removed from the object.

Parameters:
cData The IlvAbstractChartData object (or one of its derived objects) that is modified.
dataSet The data set of the cData object from which a data point is removed.
Warning:
[note] This method does nothing at this level of the class hierarchy since the class does not store the object that uses the IlvAbstractChartData object (or one of its derived objects).
virtual void IlvChartDataListener::dataPointAdded ( const IlvAbstractChartData cData,
const IlvChartDataSet dataSet,
IlUInt  position 
) [virtual]

Performs the necessary updates when a data point is added.

Performs the necessary updates to an object that uses an IlvAbstractChartData object (or one of its derived objects) when a data point is added to the object.

Parameters:
cData The IlvAbstractChartData object (or one of its derived objects) that is modified.
dataSet The data set of the cData object in which a data point is added.
position The index at which the data point is added to the data set dataSet.
Warning:
[note] This method does nothing at this level of the class hierarchy since the class does not store the object that uses the IlvAbstractChartData object (or one of its derived objects).
virtual void IlvChartDataListener::dataPointChanged ( const IlvAbstractChartData cData,
const IlvChartDataSet dataSet,
IlUInt  ptidx,
IlBoolean  beforeChange 
) [virtual]

Performs the necessary updates when a data point is changed.

Performs the necessary updates to an object that uses an IlvAbstractChartData object (or one of its derived objects) when a data point is changed in the object.

Parameters:
cData The IlvAbstractChartData object (or one of its derived objects) that is modified.
dataSet The data set of the cData object in which a data point is changed.
ptidx The index at which the data point is changed in the data set dataSet.
beforeChange A Boolean value indicating whether the method is called before the data is changed or after it has been changed.
Warning:
[note] This method does nothing at that level of the class hierarchy since the considered class does not store the object that uses the IlvAbstractChartData object (or one of its derived objects).
virtual void IlvChartDataListener::dataPointRemoved ( const IlvAbstractChartData cData,
const IlvChartDataSet dataSet,
IlUInt  ptidx 
) [virtual]

Performs the necessary updates when a data point is removed.

Performs the necessary updates to the object that uses an IlvAbstractChartData object (or one of its derived objects) when a data point is removed from the object.

Parameters:
cData The IlvAbstractChartData object (or one of its derived objects) that is modified.
dataSet The data set of the cData object from which a data point is removed.
ptidx The index of the data point that is removed from the data set dataSet.
Warning:
[note] This method does nothing at this level of the class hierarchy since the class does not store the object that uses the IlvAbstractChartData object (or one of its derived objects).
virtual void IlvChartDataListener::dataSetAdded ( const IlvAbstractChartData cData,
IlvChartDataSet dataSet,
IlUInt  position 
) [virtual]

Performs the necessary updates when a data set is added.

Performs the necessary updates to an object that uses an IlvAbstractChartData object (or one of its derived objects) when a data set is added to the object.

Parameters:
cData The IlvAbstractChartData object (or one of its derived objects) that is modified.
dataSet The data set that is added to the cData object.
position The index at which the data set is added to the cData object.
Warning:
[note] This method does nothing at this level of the class hierarchy since the class does not store the object that uses the IlvAbstractChartData object (or one of its derived objects).
virtual void IlvChartDataListener::dataSetChanged ( const IlvAbstractChartData cData,
IlvChartDataSet oldSet,
IlvChartDataSet newSet 
) [virtual]

Performs the necessary updates when a data set is changed.

Performs the necessary updates to an object that uses an IlvAbstractChartData object (or one of its derived objects) when a data set is changed in the object.

Parameters:
cData The IlvAbstractChartData object (or one of its derived objects) that is modified.
oldSet The old data set before the change to the cData object.
newSet The new data set that replaces the old data set oldSet in the cData object.
Warning:
[note] This method does nothing at this level of the class hierarchy since the class does not store the object that uses the IlvAbstractChartData object (or one of its derived objects).
virtual void IlvChartDataListener::dataSetRemoved ( const IlvAbstractChartData cData,
IlvChartDataSet dataSet 
) [virtual]

Performs the necessary updates when a data set is removed.

Performs the necessary updates to an object that uses an IlvAbstractChartData object (or one of its derived objects) when a data set is removed from the object.

Parameters:
cData The IlvAbstractChartData object (or one of its derived objects) that is modified.
dataSet The data set that is removed from the cData object.
Warning:
[note] This method does nothing at this level of the class hierarchy since the class does not store the object that uses the IlvAbstractChartData object (or one of its derived objects).
virtual void IlvChartDataListener::endBatch ( const IlvAbstractChartData cData,
const IlvChartDataSet dataSet 
) [virtual]

Specifies the end of a set of modifications on a data set.

The notification of the end of the set of modifications is triggered on the data set dataSet when the IlvChartDataSet::endBatch method is called.

Parameters:
cData The IlvAbstractChartData object (or one of its derived objects) that handles the data set dataSet.
dataSet The data set of the cData object that is modified.
virtual void IlvChartDataListener::startBatch ( const IlvAbstractChartData cData,
const IlvChartDataSet dataSet 
) [virtual]

Specifies the beginning of a set of modifications on a data set.

The notification of the beginning of the set of modifications is triggered on the data set dataSet when the IlvChartDataSet::startBatch method is called.

Parameters:
cData The IlvAbstractChartData object (or one of its derived objects) that handles the data set dataSet.
dataSet The data set of the cData object that is modified.
 All Classes Files Functions Variables Typedefs Enumerations Enumerator Friends Defines

© Copyright 2012, Rogue Wave Software, Inc. All Rights Reserved.
Rogue Wave is a registered trademark of Rogue Wave Software, Inc. in the United States and other countries. All other trademarks are the property of their respective owners.