IlvStacked3dBarChartDisplayer Class Reference

Displays data sets as stacked 3D bars. More...

#include <ilviews/charts/stacked.h>

Inheritance diagram for IlvStacked3dBarChartDisplayer:

List of all members.

Public Member Functions
	IlvStacked3dBarChartDisplayer (IlUInt count, IlvPalette *const *palettes=0, IlBoolean stacked100PerCent=IlFalse)
	Constructor.
virtual IlvAbstractChartDisplayer *	copy () const
	Virtual copy constructor.
Protected Member Functions
virtual IlvAbstractChartDisplayer *	createDisplayer (IlUInt index, IlvPalette *palette=0)
	Defines the child displayers that will be created by default to compose the current displayer.
virtual void	updateDisplayers ()
	Updates the displayers that compose the current displayer.

---

Detailed Description

Displays data sets as stacked 3D bars.

Library: ilvcharts

This class is a subclass of IlvStackedChartDisplayer which allows you to represent data with stacked 3D bars.

The stacked 3D bar displayer is a composite displayer that is composed of as many 3D bar displayers as the number of data sets you want to be stacked (see the Ilv3dBarChartDisplayer class).

The stacked 3D bar displayer displays as many data sets as you want. The data sets that are set on this displayer are represented by 3D bars. The first data set is represented at the bottom. The second one is represented stacked on the first one. The third one is represented stacked on the second one, and so on. This displayer can be used with any type of projection. (See the IlvAbstractProjector class for more details.)

The following images show data sets represented with a stacked 3D bar displayer in a Cartesian chart (on the left) and a polar chart (on the right).

See also:

IlvStackedChartDisplayer.

---

Constructor & Destructor Documentation

IlvStacked3dBarChartDisplayer::IlvStacked3dBarChartDisplayer	(	IlUInt	count,
		IlvPalette *const *	palettes = 0,
		IlBoolean	stacked100PerCent = IlFalse
	)

Constructor.

Initializes a new IlvStacked3dBarChartDisplayer object with count child displayers.

Parameters:

	count	The number of child displayers that are created.
	palettes	The palettes associated with the created child displayers. If a valid array of palettes is provided, its size must match count.
	stacked100PerCent	A Boolean indicating whether the data are stacked with the total amount equal to 100%.

---

Member Function Documentation

virtual IlvAbstractChartDisplayer* IlvStacked3dBarChartDisplayer::copy

(

)

const [virtual]

Virtual copy constructor.

Creates and returns a copy of the current object. This method must be overloaded in subclasses. It is automatically declared by the DeclareChartDisplayerTypeInfo macro. The IlvPredefinedChartDisplayerIOMembers macro lets you define a default implementation, which returns an instance initialized with the copy constructor.

Returns:

A copy of the current object.

Reimplemented from IlvStackedChartDisplayer.

virtual IlvAbstractChartDisplayer* IlvStacked3dBarChartDisplayer::createDisplayer	(	IlUInt	index,
		IlvPalette *	palette = 0
	)			[protected, virtual]

Defines the child displayers that will be created by default to compose the current displayer.

This method creates an instance of Ilv3dBarChartDisplayer. See the IlvCompositeChartDisplayer::createDisplayer method for more details.

Parameters:

	index	The index at which the created displayer will be added later to the collection of displayers that compose the current displayer.
	palette	The palette that will be used by the new displayer.

Reimplemented from IlvCompositeChartDisplayer.

virtual void IlvStacked3dBarChartDisplayer::updateDisplayers

(

)

[protected, virtual]

Updates the displayers that compose the current displayer.

This method first calls the IlvCompositeChartDisplayer::updateDisplayers method. It then sets the Boolean indicating whether the top face of the 3D bars is drawn to IlFalse for all the child displayers except the last one. This is because the top face of the stacked 3D bars must be drawn only for the last 3D bars (those that are at the top). See the IlvCompositeChartDisplayer::updateDisplayers method for more details.

Reimplemented from IlvCompositeChartDisplayer.