Setting General Properties of a Chart Layout Object

The following properties are defined for a layout object:

Property

Methods

Default Value

Areas Computation Properties

Graph and Data Display Areas

Automatically Computed

isAutoLayout

setAutoLayout

IlvTrue

    

Graph Area

Automatically Computed

isAutoGraphArea

setAutoGraphArea

IlvTrue

    

Data Display Area

Automatically Computed

isAutoDataDisplayArea

setAutoDataDisplayArea

IlvTrue

    

Areas Positioning Properties

Drawing Area Defined by:

    

    Margins Between the

    Chart Bounding Box and the

    Drawing Area

    

    

getLeftMargin

setLeftMargin

    

getRightMargin

setRightMargin

    

getTopMargin

setTopMargin

    

getBottomMargin

setBottomMargin

    

    

0

    

    

0

    

    

0

    

    

0

Graph Area Defined

by Hand Using:

    

    Margins Between the

    Drawing Area and the

    Graph Area

    

    A Rectangle Corresponding

    to the Graph Area

    

     

    

getGraphAreaRelatively

setGraphAreaRelatively

    

    

getGraphArea

setGraphArea

    

Data Display Area Defined

by Hand Using:

    

    Margins Between the

    Drawing Area and the

    Data Display Area

    

    A Rectangle Corresponding

    to the Data Display Area

    

     

        

getDataDisplayAreaRelatively

setDataDisplayAreaRelatively

    

    

getDataDisplayArea

setDataDisplayArea

    

    

By default, the graph area and the data display area are automatically computed from the drawing area. However, the graph area or the data display area can be fixed by hand. If the graph area is fixed by hand, the data display area will be computed automatically from the fixed graph area. Similarly, if the data display area is fixed by hand, the graph area will be automatically computed from the fixed data display area.

Note

Be careful when you fix the data display area by hand. If the specified data display area is not small enough, the computed graph area can be larger than the drawing area and thus a part of the drawing of the chart may be not visible on the screen.

You can fix the graph area or the data display area by hand in two ways:

  • By specifying margins relative to the drawing area

This can be done by means of the setGraphAreaRelatively or setDataDisplayAreaRelatively methods. In this case, the area that is fixed will be updated if the drawing area is modified (for example when the margins between the drawing area and the chart bounding box are changed).

  • By setting the rectangle corresponding to the area to be fixed directly

This can be done by means of the setGraphArea or setDataDisplayArea methods. In this case, the area that is fixed does not depend on the drawing area and is not updated when the drawing area is modified.