Views
Charts Package API Reference Guide
Product Documentation:
Views Documentation Home
List of all members | Public Member Functions
IlvPointInfoArray Class Reference

Class for point information objects management. More...

#include <ilviews/charts/data.h>

Inheritance diagram for IlvPointInfoArray:
IlvPointInfoCollection

Public Member Functions

 IlvPointInfoArray ()
 Initializes a new IlvPointInfoArray object.
 
virtual IlvChartDataPointInfogetInfoForPoint (IlUInt ptidx) const
 Returns the point information for a given data point. More...
 
virtual IlvChartDataPointInfogetPointInfo (IlUInt idx) const
 Returns the point information at a given index. More...
 
virtual IlUInt getPointInfoCount () const
 Returns the number of point information objects managed by this object. More...
 
virtual void removeAllPointInfo ()
 Removes all point information. More...
 
virtual IlBoolean removePointInfo (IlUInt ptidx)
 Removes the point information for a given data point. More...
 
virtual void setPointInfo (IlUInt ptidx, IlvChartDataPointInfo *ptInfo, IlBoolean copy=IlFalse)
 Sets the point information defined for a given data point. More...
 
- Public Member Functions inherited from IlvPointInfoCollection
virtual IlvPointInfoCollectioncopy () const =0
 Creates and returns a copy of the current object. More...
 
void lock ()
 Locks the current IlvPointInfoCollection object. More...
 
IlvOutputFilesave (IlvOutputFile &file) const
 Writes a complete description of the current object in a file. More...
 
void unLock ()
 Unlocks the current IlvPointInfoCollection object. More...
 
virtual void write (IlvOutputFile &file) const =0
 Writes the attributes of the current object in a file. More...
 

Additional Inherited Members

- Static Public Member Functions inherited from IlvPointInfoCollection
static IlvPointInfoCollectionLoad (IlvInputFile &file)
 Reads a point information collection object from a file. More...
 
- Protected Member Functions inherited from IlvPointInfoCollection
 IlvPointInfoCollection ()
 Initializes a new IlvPointInfoCollection object.
 
 IlvPointInfoCollection (const IlvPointInfoCollection &pointInfo)
 Initializes a new IlvPointInfoCollection object as a copy of another IlvPointInfoCollection. More...
 
 IlvPointInfoCollection (IlvInputFile &file)
 Initializes a new IlvPointInfoCollection object from an input file. More...
 

Detailed Description

Class for point information objects management.

Library: ilvcharts

This class is a subclass of IlvPointInfoCollection that stores the pointers to the point information defined for the data points of a given data set in a continuous array. The pointer to the point information object associated with the data point at a given index in a data set is stored at the same index in the IlvPointInfoArray object that is associated with this data set.

Note
The use of an IlvPointInfoArray object to store the point information objects defined for the data points of a given data set is optimal only if a point information object is defined for each data point of the data set, since the array that stores the pointers to the point information objects in an IlvPointInfoArray object always has a size equal to the number of data points in the data set with which this object is associated. If a point information object is not defined for each data point of the data set, YOU MUST use an IlvPointInfoMap object to store the point information objects defined for the data points of a given data set.
See also
IlvPointInfoCollection, IlvChartDataPointInfo.

Member Function Documentation

◆ getInfoForPoint()

virtual IlvChartDataPointInfo* IlvPointInfoArray::getInfoForPoint ( IlUInt  pidx) const
virtual

Returns the point information for a given data point.

Parameters
pidxThe index of the data point with which the returned point information is associated.
Returns
A pointer to the point information associated with the data point at the index pidx in the data set with which the current object is associated. The returned point information should not be deleted since it is maintained internally.

Implements IlvPointInfoCollection.

◆ getPointInfo()

virtual IlvChartDataPointInfo* IlvPointInfoArray::getPointInfo ( IlUInt  idx) const
virtual

Returns the point information at a given index.

Parameters
idxThe index of the returned point information.
Returns
A pointer to the point information at the index idx in the collection of point information objects managed by the current object. The returned point information stores graphical information for a data point of the data set with which the current object is associated. This point information should not be deleted since it is maintained internally.

Implements IlvPointInfoCollection.

◆ getPointInfoCount()

virtual IlUInt IlvPointInfoArray::getPointInfoCount ( ) const
virtual

Returns the number of point information objects managed by this object.

Returns
The number of point information objects managed by this object.

Implements IlvPointInfoCollection.

◆ removeAllPointInfo()

virtual void IlvPointInfoArray::removeAllPointInfo ( )
virtual

Removes all point information.

Removes all the point information objects that are managed by the current object.

Note
When you remove a point information object, the point information object is not deleted but unlocked (that is, the IlvChartDataPointInfo::unLock() method is called). It will be deleted only when no more objects reference it (see the IlvChartDataPointInfo::unLock() method).

Implements IlvPointInfoCollection.

◆ removePointInfo()

virtual IlBoolean IlvPointInfoArray::removePointInfo ( IlUInt  ptidx)
virtual

Removes the point information for a given data point.

When you remove a point information object, the point information object is not deleted but it is unlocked (that is, the IlvChartDataPointInfo::unLock() method is called). It will be deleted only when no objects reference it (see the IlvChartDataPointInfo::unLock() method).

Parameters
ptidxThe index of the data point with which the point information that is removed is associated.
Returns
IlTrue if the point information has been removed and IlFalse otherwise.

Implements IlvPointInfoCollection.

◆ setPointInfo()

virtual void IlvPointInfoArray::setPointInfo ( IlUInt  ptidx,
IlvChartDataPointInfo ptInfo,
IlBoolean  copy = IlFalse 
)
virtual

Sets the point information defined for a given data point.

If a point information object has already been stored in the current object for the data point at index ptidx, this point information is replaced by ptInfo. The new point information ptInfo is locked.

Parameters
ptidxThe index of the data point for which the point information is set.
ptInfoThe new point information.
copyIndicates whether the point information passed as a parameter must be copied: If copy is IlTrue, the point information is copied. Otherwise, a pointer to the point information stored in ptInfo is kept and so its contents should not be deleted since it is maintained internally.

Implements IlvPointInfoCollection.