Options > Charts > Using the Charts Library > Chart Layout > Computing the Chart Layout > Setting General Properties of a Chart Layout Object
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.
Published date: 05/24/2022
Last modified date: 02/24/2022