IlvChartDataGraphicInfo Class Reference

Allows you to draw an IlvGraphic object next to a data point. More...

#include <ilviews/charts/data.h>

Inheritance diagram for IlvChartDataGraphicInfo:

List of all members.

Public Member Functions
	IlvChartDataGraphicInfo (IlvGraphic *graphic, IlvPos dx=0, IlvPos dy=0, IlvPosition anchorPosition=IlvCenter, IlvPalette *palette=0)
	Constructor.
virtual	~IlvChartDataGraphicInfo ()
	Destructor.
virtual IlBoolean	boundingBox (const IlvPoint &point, const IlvChartDataSet *dataSet, IlUInt ptidx, const IlvChartGraphic *chart, IlvRect &bbox, const IlvTransformer *t=0) const
	Returns the bounding box of the graphical information drawn next to the representation of the data point.
virtual void	draw (const IlvPoint &point, const IlvChartDataSet *dataSet, IlUInt ptidx, const IlvChartGraphic *chart, IlvPort *dst, const IlvTransformer *t=0, const IlvRegion *clip=0) const
	Draws some graphical information next to the representation of the data point.
IlvPosition	getAnchorPosition () const
	Returns the anchor position of the graphic object.
IlvGraphic *	getGraphic () const
	Returns the stored graphic object.
const IlvPoint &	getOffset () const
	Returns the offset that is used to draw the graphic object.
void	setAnchorPosition (IlvPosition position)
	Sets the anchor position of the graphic object.
void	setGraphic (IlvGraphic *graphic)
	Sets the graphic object that is drawn.
virtual void	setMode (IlvDrawMode mode)
	Sets the drawing mode.
void	setOffset (const IlvPoint &offset)
	Sets the offset that is used to draw the stored graphic object.
virtual void	setOverwrite (IlBoolean o)
	Sets the way the drawing member functions operate.

---

Detailed Description

Allows you to draw an IlvGraphic object next to a data point.

Library: ilvcharts

This class is a subclass of IlvChartDataPointInfo that is used to draw any kind of graphic object (an instance of a subclass of the IlvGraphic class) next to the representation of a data point.

Each instance stores a graphic object and information specifying the location where the graphic object is drawn with respect to the location of the projected data point. This information includes:

• The position that specifies which point of the bounding box of the graphic object is positioned relative to the projected data point. This point is called the anchor point.
• The offset between the projected data point and the anchor point.

See also:

IlvChartDataPointInfo, IlvPointInfoCollection.

---

Constructor & Destructor Documentation

IlvChartDataGraphicInfo::IlvChartDataGraphicInfo	(	IlvGraphic *	graphic,
		IlvPos	dx = 0,
		IlvPos	dy = 0,
		IlvPosition	anchorPosition = IlvCenter,
		IlvPalette *	palette = 0
	)

Constructor.

Initializes a new IlvChartDataGraphicInfo object.

Parameters:

	graphic	The stored graphic object.
	dx	The x-offset that is used to draw the graphic object from the projected data point.
	dy	The y-offset that is used to draw the graphic object from the projected data point.
	anchorPosition	The position that specifies which point of the bounding box of graphic will be positioned at the offset (dx, dy) from the projected data point.
	palette	The palette that is used to draw the data point.

virtual IlvChartDataGraphicInfo::~IlvChartDataGraphicInfo

(

)

[virtual]

Destructor.

The destructor deletes the stored graphic object.

---

Member Function Documentation

virtual IlBoolean IlvChartDataGraphicInfo::boundingBox	(	const IlvPoint &	point,
		const IlvChartDataSet *	dataSet,
		IlUInt	ptidx,
		const IlvChartGraphic *	chart,
		IlvRect &	bbox,
		const IlvTransformer *	t = 0
	)			const [virtual]

Returns the bounding box of the graphical information drawn next to the representation of the data point.

Returns the bounding box of the stored graphic object.

Parameters:

	point	The coordinates of the projected data point.
	dataSet	The data set holding the considered data point.
	ptidx	The index of the considered data point in the dataSet dataSet.
	chart	The chart object for which the graphical information is drawn.
	bbox	The returned bounding box.
	t	The applied transformer.

Returns:

IlTrue if the bounding box has been successfully computed and IlFalse otherwise.

Reimplemented from IlvChartDataPointInfo.

Reimplemented in IlvChartDataPointLabel.

virtual void IlvChartDataGraphicInfo::draw	(	const IlvPoint &	point,
		const IlvChartDataSet *	dataSet,
		IlUInt	ptidx,
		const IlvChartGraphic *	chart,
		IlvPort *	dst,
		const IlvTransformer *	t = 0,
		const IlvRegion *	clip = 0
	)			const [virtual]

Draws some graphical information next to the representation of the data point.

Draws the stored graphic object with respect to the projected data point given by point.

Parameters:

	point	The coordinates of the projected data point.
	dataSet	The data set holding the considered data point.
	ptidx	The index of the considered data point in the dataSet dataSet.
	chart	The chart object for which the graphical information is drawn.
	dst	The port where the graphical representation is drawn.
	t	The transformer applied to dst.
	clip	The clipping region.

Reimplemented from IlvChartDataPointInfo.

Reimplemented in IlvChartDataPointLabel.

IlvPosition IlvChartDataGraphicInfo::getAnchorPosition

(

)

const

Returns the anchor position of the graphic object.

The position determines the point on the bounding box of the graphic object that used as an anchor to compute where this object should be drawn. This point on the bounding box will be positioned at the offset returned by the IlvChartDataGraphicInfo::getOffset method from the projected data point.

Returns:

The anchor position of the graphic object.

See also:

getOffset.

IlvGraphic* IlvChartDataGraphicInfo::getGraphic

(

)

const

Returns the stored graphic object.

Returns:

The stored graphic object.

const IlvPoint& IlvChartDataGraphicInfo::getOffset

(

)

const

Returns the offset that is used to draw the graphic object.

The offset is used in conjunction with the anchor position to determine the location where the graphic object is drawn with respect to the location of the projected data point.

Returns:

The offset that is used to draw the graphic object.

See also:

getAnchorPosition

void IlvChartDataGraphicInfo::setAnchorPosition

(

IlvPosition

position

)

Sets the anchor position of the graphic object.

Parameters:

position

The new anchor position.

See also:

getAnchorPosition.

void IlvChartDataGraphicInfo::setGraphic

(

IlvGraphic *

graphic

)

Sets the graphic object that is drawn.

The previous graphic object is deleted and replaced with graphic.

Parameters:

graphic

The new graphic object.

virtual void IlvChartDataGraphicInfo::setMode

(

IlvDrawMode

mode

)

[virtual]

Sets the drawing mode.

Sets the drawing mode for the current object. The information is passed to the palette stored by the object.

Parameters:

mode

The new drawing mode for the current object.

Reimplemented from IlvChartDataPointInfo.

void IlvChartDataGraphicInfo::setOffset

(

const IlvPoint &

offset

)

Sets the offset that is used to draw the stored graphic object.

Parameters:

offset

The new offset.

See also:

getOffset

virtual void IlvChartDataGraphicInfo::setOverwrite

(

IlBoolean

o

)

[virtual]

Sets the way the drawing member functions operate.

Modifies the way the drawing member functions of the current object operate, when drawing on the root port. If the o parameter is set to IlFalse, the drawing operations are hidden by the windows stored on the top window. If the parameter is set to IlTrue, the drawing operations are performed on top of every window present on the screen, just as if the windows were part of the root window. The information is passed to the palette stored by the object.

Parameters:

o

The new value of the Boolean indicating the way the drawing member functions operate.

Reimplemented from IlvChartDataPointInfo.