grAxisTitle (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / WLanguage functions / Controls, pages and windows / Chart management functions

Types of charts
Title of axes
Languages that use a non-Latin character set

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

grAxisTitle (Function)

In french: grTitreAxe

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.

Caution: A specific configuration is required to use this function in Linux. For more details, see The charts.

Example

// 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)

Syntax

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.
Only Chart controls are available.
Only the interactive Chart controls are available.

<Title>: Character string

Title of specified axis.

<Axis direction>: Constant

Orientation of axis to use:
grSecondaryYCoordinate Marks on secondary Y-axis (vertical axis).
grXCoordinate
(default value) Marks on X-axis (horizontal axis).
grYCoordinate Marks on Y-axis (vertical axis).

Remarks

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.

The font used for the chart title can be modified by grAxisTitleFont.

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.

Component: wd280grf.dll