PC SOFT

WINDEVWEBDEV AND WINDEV MOBILE
ONLINE HELP

Home | Sign in | English UK

WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
grSourceCategoryLabel (Function)
In french: grSourceEtiquetteCatégorie
Defines the source of the category labels.
IF grSourceCategoryLabel("MyChart", grTableColumn, "MyTable.MyColumn") = True THEN
Info("The source of the category labels is MyColumn")
END
Syntax
<Result> = grSourceCategoryLabel(<Chart name> , <Source> [, <Details 1> [... [, <Details N>]]])
<Result>: Boolean
  • True if the source was defined,
  • False otherwise. To find out the error details, use ErrorInfo.
<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.
<Source>: Integer constant
Data source of the chart:
grTableColumnCategory labels filled from a table column.

In this case, <Details 1> corresponds to the name of a table column. This name must correspond to the full name of the column, enclosed in quotes (for example: "<TableName>.<ColumnName>").
The column is browsed to fill the series. If one of the values is not a numeric value, a "hole" is created in the series.
grCallbackCategory labels filled by a WLanguage function/procedure.
In this case, <Details 1> corresponds to the name of the WLanguage procedure to call.

The procedure is called for each number. This procedure has the following format:
PROCEDURE MyProcedure(<Chart name>,
<Series number>, <Index in series>)

The procedure returns the requested number. To specify the end of the series, the procedure must return False.
grListBoxCategory labels filled from a list box.

In this case, <Details 1> corresponds to the name of a list box. The list box is browsed to fill the series. If one of the values is not a numeric value, a "hole" is created in the series.
grProgrammingCategory labels filled by programming.

<Details 1> can correspond to a series of numbers in the same character string, separated by ";".
grItemCategory labels filled from an item.

<Details 1> corresponds to the name of the file (or query), <Details 2> corresponds to the name of the item. The series will browse the file and will take all the values of the item.

If one of the values is not a numeric value, a "hole" is created in the series.
grTableCategory labels filled from a WLanguage array.

<Details 1> corresponds to the name of the array. <Details 2> can correspond to the subscript of the column (two-dimensional array) or to the name of a member (array of structures).
<Details 1>: Expected type (optional parameter)
First expected parameter, according to the type of the data source.
<Details N>: Expected type (optional parameter)
Last expected parameter, according to the type of the data source.
Related Examples:
WD 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.
Component : wd240grf.dll
Minimum version required
  • Version 10
This page is also available for…
Comments
Click [Add] to post a comment