grLabel (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Controls, pages and windows

Functions for managing charts

grScatter3DDeleteAltitudeColor

gr3DSParameter

grAddData

grAddTimeData

grAutoRefreshCategoryLabel

grComparativeSeriesPosition

grDonutHolePercentage

grScatter3DAltitudeColor

grScatter3DDeleteMarkCaption

grScatter3DGridlines

grScatter3DLinkPoint

grScatter3DMarkCaption

grScatter3DProjection

grSeriesSecondaryAxis

grSeriesType

grSmoothing

grSourceCategoryLabel

grSunburstRootSection

grSunburstSectionColor

grSunburstStartAngle

grSurfaceAddData

grSurfaceAltitudeColor

grSurfaceDeleteAltitudeColor

grSurfaceDeleteMarkCaption

grSurfaceGetData

grSurfaceGridlines

grSurfaceMarksCaption

grWaterfallCategoryType

grWaterfallColor

grWndSize

grZoom

Chart caption

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

grLabel (Function)

In french: grLibellé

Indicates various parameters of additional legend in a chart.

Example of additional legends:

Versions 15 and later

This function is now available for WEBDEV sites in Linux.

Caution: A specific configuration is required to use this function in Linux. See The charts for more details.

New in version 15

This function is now available for WEBDEV sites in Linux.

Caution: A specific configuration is required to use this function in Linux. See The charts for more details.

This function is now available for WEBDEV sites in Linux.

Caution: A specific configuration is required to use this function in Linux. See The charts for more details.

Versions 16 and later

This function is now available for WINDEV applications in Linux.

New in version 16

This function is now available for WINDEV applications in Linux.

Versions 17 and later

This function is now available for iPhone/iPad applications.

New in version 17

This function is now available for iPhone/iPad applications.

Versions 18 and later

This function is now available in Windows Store apps mode.

New in version 18

This function is now available in Windows Store apps mode.

Versions 19 and later

This function is now available for Android applications.

New in version 19

This function is now available for Android applications.

Versions 21 and later

This function is now available in Universal Windows 10 App mode.

New in version 21

This function is now available in Universal Windows 10 App mode.

Versions 23 and later

This function is now available for PHP sites.

New in version 23

This function is now available for PHP sites.

This function is now available for PHP sites.

Example

// Chart created by programming
// Display the caption for the labels of data categories in "MyChart"
grLabel("MyChart", grShowLabel, True)

// Chart control
// Display the caption for the percentages of data categories in "CHART_MyChart"
grLabel(CHART_Chart, grShowPercent, True)

Syntax

grLabel(<Chart name> , <Additional legend> , <Display>)

<Chart name>: Character string (with or without quotes)

Name of chart to use. This name corresponds to:
the chart name defined by programming with grCreate.
the name of Chart control found in the window editor, page editor or report editor.
Only the Chart controls are available.
Only the interactive Chart controls are available.

<Additional legend>: Constant

Additional legend that will be displayed with the chart:
with a pie chart:
grShowLabel Label of data categories.
grShowPercent Percentage of data categories.
grShowValue Value of data categories.
with a column chart:
grShowValue Value of data categories.
with a stacked column chart:
grShowValueIfNull Label of data categories, even for the null values in the stacked column chart.

<Display>: Boolean

True if the additional legend must be displayed,
False otherwise.

Remarks

Chart caption

The chart caption can include three elements:

the category labels.
the value of categories.
the percentage of categories.

The chart caption can be displayed for the pie charts, column charts and stacked column charts only.

grLabel is used to display the different elements of the chart caption. Different elements are displayed according to the type of chart.

The category labels displayed correspond to the ones defined by grCategoryLabel.

The value of categories depends on the chart data.

The percentage of categories is automatically calculated.

The information display can be formatted by grMask.

The modifications performed by grLabel will be taken into account during the next call to grDraw.

Related Examples:

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

Training (WINDEV): WD Chart

[ + ] This educational example present different uses of the chart control.
The following charts are presented:
- Semi-circular
- Donut
- Pie
- Sunburst
- Line
- Scatter
- 3D Scatter
- Column
- Area
- Bubble
- Radar
- Funnel
- Surface
- Waterfall
- Composite

The main features presented in this example are the ability to customize the charts by programming as well as the method used to fill a chart from a HFSQL file or in the editor.

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 : wd250grf.dll