PC SOFT

ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Home | Sign in | English EN

  • Managing the category labels
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
Allows you to:
  • Initialize the label of a data category (or section) in a chart.
    WEBDEV - Browser code Not available.
  • Versions 25 and later
    Get the label of a data category (or section) in a chart.
    New in version 25
    Get the label of a data category (or section) in a chart.
    Get the label of a data category (or section) in a chart.
Example of category label:
Category label
Reminder: A chart element has no label by default.
Versions 15 and later
WEBDEV - Server codeLinux This function is now available for WEBDEV sites in Linux.
Linux Caution: A specific configuration is required to use this function in Linux. For more details, see The charts.
New in version 15
WEBDEV - Server codeLinux This function is now available for WEBDEV sites in Linux.
Linux Caution: A specific configuration is required to use this function in Linux. For more details, see The charts.
WEBDEV - Server codeLinux This function is now available for WEBDEV sites in Linux.
Linux Caution: A specific configuration is required to use this function in Linux. For more details, see The charts.
Versions 16 and later
WINDEVLinux This function is now available for WINDEV applications in Linux.
New in version 16
WINDEVLinux This function is now available for WINDEV applications in Linux.
WINDEVLinux This function is now available for WINDEV applications in Linux.
Versions 17 and later
iPhone/iPad This function is now available for iPhone/iPad applications.
New in version 17
iPhone/iPad This function is now available for iPhone/iPad applications.
iPhone/iPad This function is now available for iPhone/iPad applications.
Versions 19 and later
Android This function is now available for Android applications.
New in version 19
Android This function is now available for Android applications.
Android This function is now available for Android applications.
Versions 21 and later
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
New in version 21
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
Versions 23 and later
PHP This function is now available for PHP sites.
New in version 23
PHP This function is now available for PHP sites.
PHP This function is now available for PHP sites.
Versions 25 and later
WEBDEV - Browser code This function is now available in browser code.
New in version 25
WEBDEV - Browser code This function is now available in browser code.
WEBDEV - Browser code This function is now available in browser code.
Example
// Initialize the "February" label of the second data category
// in "MyChart"
grCategoryLabel("MyChart", 2, "February")
// Initialize the "February" label of the second data category
// in "MyChart"
grCategoryLabel(CHART_MyChart, 2, "February")
Versions 25 and later
// Read label of second data category
// in "MyChart"
MyLabel is string = grCategoryLabel(CHART_MyChart, 2)
New in version 25
// Read label of second data category
// in "MyChart"
MyLabel is string = grCategoryLabel(CHART_MyChart, 2)
// Read label of second data category
// in "MyChart"
MyLabel is string = grCategoryLabel(CHART_MyChart, 2)
Syntax
WEBDEV - Browser code Not available in browser code

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

grCategoryLabel(<Chart name> , <Index> , <Label>)
<Chart name>: Control name or character string
Name of the chart to be used. This name corresponds to:
  • the chart name defined through programming with grCreate.
  • the name of the Chart control in the window, page or report editor.
Android Only Chart controls are available.
PHP Only the interactive Chart controls are available.
<Index>: Integer
Data index 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, grCategoryLabel must be systematically called whenever adding data into the chart with grAddData.
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, grCategoryLabel must be systematically called whenever adding data into the chart with grAddData.
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, grCategoryLabel must be systematically called whenever adding data into the chart with grAddData.
Versions 25 and later

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

<Result> = grCategoryLabel(<Chart name> , <Index>)
<Result>: Character string
Label caption.
<Chart name>: Control name or character string
Name of the chart to be used. This name corresponds to:
  • the chart name defined through programming with grCreate.
  • the name of the Chart control in the window, page or report editor.
Android Only Chart controls are available.
PHP Only the interactive Chart controls are available.
<Index>: Integer
Data index (with the desired label) in the series.
New in version 25

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

<Result> = grCategoryLabel(<Chart name> , <Index>)
<Result>: Character string
Label caption.
<Chart name>: Control name or character string
Name of the chart to be used. This name corresponds to:
  • the chart name defined through programming with grCreate.
  • the name of the Chart control in the window, page or report editor.
Android Only Chart controls are available.
PHP Only the interactive Chart controls are available.
<Index>: Integer
Data index (with the desired label) in the series.

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

<Result> = grCategoryLabel(<Chart name> , <Index>)
<Result>: Character string
Label caption.
<Chart name>: Control name or character string
Name of the chart to be used. This name corresponds to:
  • the chart name defined through programming with grCreate.
  • the name of the Chart control in the window, page or report editor.
Android Only Chart controls are available.
PHP Only the interactive Chart controls are available.
<Index>: Integer
Data index (with the desired label) in the series.
Remarks

Managing the category labels

The category labels are displayed:
  • below the horizontal marks for Line and Stock charts (Candlestick and BarCharts),
  • below the X-axis for Column and MinMax charts.
Category label
Category labels cannot be used in Scatter charts.
The position of the category labels cannot be changed.
The category labels are defined by grCategoryLabel.
The data defined by grCategoryLabel will be taken into account during the next call to grDraw.
The label font can be modified by grLabelFont.
The category labels defined by grCategoryLabel can be displayed in the label of Pie charts (grShowLabel constant used with grLabel).
Related Examples:
WD 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.
The Chart functions 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
The Chart functions 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, ...)
The Chart control 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
The Chart functions 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, ...)
Business / UI classification: Neutral code
Component: wd270grf.dll
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment