Defines the title of X-axis and the title of Y-axis in a chart.
Example of titles for the chart axes:
Remark: No title is defined by default for the axes of a chart.
: A specific configuration is required to use this function in Linux. For more details, see The charts
// Modify the title of the vertical axis in "MyChart"
grAxisTitle("MyChart", "Time", grYCoordinate)
// Modify the title of the horizontal axis in "CHART_MyChart"
grAxisTitle(CHART_MyChart, "Time", grYCoordinate)
grAxisTitle(<Chart name> , <Title> , <Axis direction>)
<Chart name>: Control name or character string
Name of the chart to be used. This name corresponds to:
- the chart name defined through programming with grCreate.
- the name of the Chart control in the window, page or report editor.
<Title>: Character string
Title of specified axis.
<Axis direction>: Constant
Orientation of axis to use:
|grSecondaryYCoordinate||Marks on secondary Y-axis (vertical axis).|
|Marks on X-axis (horizontal axis).|
|grYCoordinate||Marks on Y-axis (vertical axis).|
Types of charts
Depending on the type of chart and on <Axis direction>, grAxisTitle is taken into account or not:
|Chart type||Horizontal axis||Vertical axis|
|Line chart||grAxisTitle taken into account.||grAxisTitle taken into account.|
|Stock chart (Candlestick and BarChart)||grAxisTitle taken into account.||grAxisTitle taken into account.|
|Column chart||grAxisTitle taken into account.||grAxisTitle taken into account.|
|Min/Max Stock chart||grAxisTitle taken into account.||grAxisTitle taken into account.|
|Scatter||grAxisTitle taken into account.||grAxisTitle taken into account.|
|Pie||grAxisTitle not taken into account.||grAxisTitle not taken into account.|
The modifications performed by grAxisTitle
will be taken into account during the next call to grDraw
Title of axes
The title of chart axes can be displayed for the different axes.
The title of the chart axes is defined by grAxisTitle
. This function can also be used to position this title according to the desired axis. You cannot define the positioning and/or the orientation of the title in relation to the axis.
Languages that use a non-Latin character set
grAxisTitle will use the selected non-Latin character set only if the associated project configuration uses UNICODE strings at runtime.
To check the selected option in the current configuration:
- On the "Project" tab, in the "Project configuration" group, click "Current configuration".
- Go to the "Unicode" tab: "Use UNICODE strings at runtime" must be checked.
- Validate if necessary.