Using the Charts Library > Decorations Display > Displaying a Grid > Adding a Grid Displayer to a Scale
 
Adding a Grid Displayer to a Scale
Since a grid is attached to a scale, the type of the grid used for a given scale depends on the type of the scale. The type of the scales that can be used for a given chart depends on the type of the projection used in the chart.
The following table lists the type of scale displayers and grid displayers that can be used for a Cartesian chart, which uses a Cartesian projection.
Chart type
Cartesian
Projection used
Cartesian
Scale Displayers
    
    Abscissa Coordinate
    
    
    Ordinate Coordinate(s)
    
    
Rectangular
    
Rectangular
Grid Displayers
    
    Abscissa Coordinate
    
    
    Ordinate Coordinate(s)
    
    
    
Rectangular
    
Rectangular
The following table lists the type of scale displayers and grid displayers that can be used for a polar chart, which uses a polar projection.
Chart type
Polar
Projection used
Polar
Scale Displayers
    
    Abscissa Coordinate
    
    
    Ordinate Coordinate(s)
    
    
Circular
    
Rectangular
Grid Displayer(s)
     
    Abscissa Coordinate
    
    
    Ordinate Coordinate(s)
    
    
     
Radial
    
Circular
Figure 10.4 shows examples of grids that are set on the scales of two charts. Grids are set on scales in a Cartesian chart (using a Cartesian projection) and in a polar chart (using a polar projection).
Figure 10.4    Grids in a Cartesian Chart and in a Polar Chart
To create and set a grid attached to a given scale, perform the following steps:
1. Create the grid displayer to display the grid that will be attached to the scale.
Do one of the following:
*Look at the tables at the beginning of this section to determine which grid can be used with the scale and create the corresponding grid displayer by hand.
or
*Use the createGridDisplayer method of the scale displayer. This method will create the correct grid displayer to be used with the scale for you.
IlvAbstractGridDisplayer* gridDisplayer =
scaleDisplayer->createGridDisplayer(referenceScaleDisplayer);
The scale displayer passed as a parameter is the displayer of the scale that must be used as a reference to know where the lines of the grid must stop. If the grid is attached to the scale representing the abscissa coordinate, the scale displayer that is passed as a parameter is the displayer of a scale representing an ordinate coordinate. If the grid is attached to a scale representing the ordinate coordinate, the scale displayer that is passed as a parameter is the displayer of the scale representing the abscissa coordinate.
2. Set the created grid displayer on the displayer of the scale to which you want to attach the grid.
scaleDisplayer->setGridDisplayer(gridDisplayer);
The Charts Library also provides some methods at the level of a chart object that directly encapsulate the creation and setting of a grid on a scale of the chart object. The following methods are available:
*IlvChartGraphic::addAbscissaGrid to add a grid on the abscissa scale.
*IlvChartGraphic::addOrdinateGrid to add a grid on an ordinate scale.

Version 5.7
Copyright © 2013, Rogue Wave Software, Inc. All Rights Reserved.