<Chart>.Label (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

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

Chart caption

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

<Chart>.Label (Function)

In french: <Graphe>.Libellé

Indicates various parameters of additional legend in a chart.

Example of additional parameters:

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

Example

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

Syntax

<Chart control>.Label(<Additional legend> , <Display>)

<Chart control>: Control name

Name of the Chart control to use (in the window, page or report editor).
Only 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.

Chart captions can only be displayed in Pie, Column and Stacked Column charts.

<Chart>.Label displays 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 <Chart>.CategoryLabel.

The value of categories depends on the chart data.

The percentage of categories is automatically calculated.

The information display can be formatted by <Chart>.Mask.

Any changes made with <Chart>.Label will take effect the next time <Chart>.Draw is called.

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