grSeriesLabel (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

Series labels
Equivalence

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

grSeriesLabel (Function)

In french: grEtiquetteSérie

Initializes the label of a data series in a chart.

Example of series label:

To display the label, use grLegend.

Reminder: By default, a graph has no label.. For more details on managing legends, labels, etc., see Managing legends in the charts.

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

Example

// Initialisation de l'étiquette "Ventes" de la série de données 2 dans le graphe "MonGraphe"
grSeriesLabel("MonGraphe", 2, "Ventes")

// Initialisation de l'étiquette "Ventes" de la série de données 2 dans le champ GRF_MonGraphe
grSeriesLabel(GRF_MonGraphe, 2, "Ventes")

Syntax

grSeriesLabel(<Chart name> , <Series number> , <Label>)

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

<Series number>: Integer

Number of the series for which a label will be initialized.

<Label>: Character string

Caption of label to initialize.

Remarks

Series labels

The set of series labels correspond to the chart legend.

Series labels cannot be used in pie charts.

Series labels are defined with grSeriesLabel.

The data defined by grSeriesLabel will be taken into account during the next call to grDraw.

The legend font can be changed with grLegendFont.

grLegend indicates the presence and position of the legend (i. e. all series labels).

Note: To define series labels in scatter charts, use function grScatterSeriesLabel.

Equivalence

The grSeriesLabel function is equivalent to the Legend property.

Related Examples:

Training (WINDEV): WD Chart

[ + ] This example presents the different uses of the Chart control.
Different types of charts are presented:
- Pie
- Sunburst
- Line
- Scatter
- Column
- Area
- etc.

The main features presented here are the possibility to customize of charts from the code, as well as to fill the chart from an HFSQL data file, or in the editor.

Unit examples (WINDEV): The Chart functions

[ + ] Using the main chart designer features of WINDEV:
- Create a Pie, Column or Line chart
- Define the display area of a chart
- Define the chart options (legend, percentage, ...)
- Draw a line on a chart

Unit examples (WEBDEV): The Chart functions

[ + ] This example presents the main features of the chart designer of WEBDEV and it allows you to:
- Create a chart: Pie, Column or Line
- Define the display area of a chart
- Define the options of the chart (legend, percentage, ...)

Unit examples (WINDEV Mobile): The Chart functions

[ + ] Using the Chart functions:
- create a Pie, Column or Line chart by programming
- define the chart options (legend, percentage, ...)

Component: wd300grf.dll