grAxisTitle (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

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

Types of charts
Title of axes
Languages that use a non-Latin character set
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:

Note By default, the axes of a graph have no title.

Caution: In Linux, this function requires a specific configuration. For more details, see The charts.

Example

// Modification du titre de l'axe vertical du graphe "MonGraphe"
grAxisTitle("MonGraphe", "Temps", grYCoordinate)

// Modification du titre de l'axe horizontal du graphe "GRF_MonGraphe"
grAxisTitle(GRF_MonGraphe, "Temps", grXCoordinate)

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 name of the chart defined programmatically with grCreate.
the name of the Chart control in the window, page or report editor.
Only 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.

Any changes made with grAxisTitle will take effect the next time grDraw is called.

Title of axes

The title of chart axes can be displayed for the different axes.

The content of the title for 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:

In the "Project Explorer" pane, display the context menu for the "Configurations" option and select "Description".
Display the "Unicode" tab: the "Use UNICODE strings at runtime" option must be checked.
Validate if necessary.

Component: wd300grf.dll