<Chart>.CategoryLabel (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

Managing the category labels

Related examples

See also

<Chart>.CategoryLabel (Function)

In french: <Graphe>.EtiquetteCatégorie

Allows you to:

Initialize the label of data category (or section) in a chart.
Versions 25 and later
Find out the label of data category (or section) in a chart.
New in version 25
Find out the label of data category (or section) in a chart.
Find out the label of data category (or section) in a chart.

Example of category label:

Reminder: A chart element has no label by default.

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

Example

// Initialize the "January" label of second data category
// in "MyChart"
CHART_MyChart.CategoryLabel(2, "January")

Versions 25 and later

// Read label of second data category
// in "MyChart"
MyLabel is string = CHART_MyChart.CategoryLabel(2)

New in version 25

// Read label of second data category
// in "MyChart"
MyLabel is string = CHART_MyChart.CategoryLabel(2)

Syntax

Initializing the label of data category (or section) in a chart Hide the details

<Chart control>.CategoryLabel(<Subscript> , <Label>)

<Chart control>: Control name

Name of the Chart control to use (found in the window editor, page editor or report editor).

<Subscript>: Integer

Subscript of data in the series.

<Label>: Character string

Caption of label to initialize.
Versions 23 and later
This parameter can also correspond to a duration, a date, a time or a date-time.
Remark: If you are using a temporal abscissa scale, <Chart>.CategoryLabel must be systematically called whenever adding data into the chart with <Chart>.AddData.
New in version 23
This parameter can also correspond to a duration, a date, a time or a date-time.
Remark: If you are using a temporal abscissa scale, <Chart>.CategoryLabel must be systematically called whenever adding data into the chart with <Chart>.AddData.
This parameter can also correspond to a duration, a date, a time or a date-time.
Remark: If you are using a temporal abscissa scale, <Chart>.CategoryLabel must be systematically called whenever adding data into the chart with <Chart>.AddData.

Versions 25 and later

Finding out the label of data category (or section) in a chart Hide the details

<Result> = grCategoryLabel(<Chart control> , <Subscript>)

<Result>: Character string

Label caption.

<Chart control>: Control name

Name of the Chart control to use (found in the window editor, page editor or report editor).

<Subscript>: Integer

Subscript of data (whose label is searched for) in the series.

New in version 25

Finding out the label of data category (or section) in a chart Hide the details

<Result> = grCategoryLabel(<Chart control> , <Subscript>)

<Result>: Character string

Label caption.

<Chart control>: Control name

Name of the Chart control to use (found in the window editor, page editor or report editor).

<Subscript>: Integer

Subscript of data (whose label is searched for) in the series.

Finding out the label of data category (or section) in a chart Hide the details

<Result> = grCategoryLabel(<Chart control> , <Subscript>)

<Result>: Character string

Label caption.

<Chart control>: Control name

Name of the Chart control to use (found in the window editor, page editor or report editor).

<Subscript>: Integer

Subscript of data (whose label is searched for) in the series.

Remarks

Managing the category labels

The category labels are displayed:

below the horizontal marks for the Line charts and Stock charts (Candlestick and BarCharts),
below the X axis for the column charts and MinMax charts.

The category labels cannot be used with the Scatter charts.

The category labels are defined by <Chart>.CategoryLabel.

The data defined by <Chart>.CategoryLabel will be taken into account during the next call to <Chart>.Draw.

The label font can be modified by <Chart>.LabelFont.

The category labels defined by <Chart>.CategoryLabel can be displayed in the label of Pie charts (grShowLabel constant used with <Chart>.Label).

Related Examples:

Training (WINDEV): WD Chart

[ + ] This example shows the 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
- Comparative

The main features presented in this example are the customization of charts by programming, as well as the method used to fill a chart from an HFSQL 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 control

[ + ] Using the Chart control to display different types of charts:
- Pie (or pie chart)
- Line
- Column chart
- Area

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