ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Controls, pages and windows / Chart functions
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
Defines the source of a series.
Linux Caution: A specific configuration is required to use this function in Linux. For more details, see The charts.
Example
// Chart control filled from a Table control column
IF grSourceSeries(CHART_MyChart1, 3, grTableColumn, "Table1.Column1") = True THEN
Info("The source of series 3 is MyColumn from now on")
END
// Chart control based on an item of an SQL query
MyQuery is Data Source
 
MySQLCode is string = QRY_Query1.SQLCode
HExecuteQuery(MyQuery, hQueryDefault, MySQLCode)
grSourceSeries(CHART_Chart1, 1, grItem, "MyQuery", "TotalBT")
grDraw(CHART_Chart1)
 
CASE ERROR:
Error(HErrorInfo())
Syntax
<Result> = grSourceSeries(<Chart name> , <Series number> , <Source> [, <Details 1> [... [, <Details N>]]])
<Result>: Boolean
  • True if the source was defined,
  • False otherwise. To get more details on the error, use ErrorInfo.
<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.
<Series number>: Integer
Number of the affected series.
<Source>: Integer constant
Data source of the chart:
grCallbackSeries 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 desired number. To specify the end of the series, the procedure must return False.
Universal Windows 10 App This constant is not available.
grItemSeries filled from an item.

<Details 1> corresponds to the name of the data file (or query), <Details 2> corresponds to the name of the item. The series will browse through the data 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.
grListBoxSeries filled from a List Box control.

In this case, <Details 1> corresponds to the name of a List Box control. The List Box control is browsed to fill the series. If one of the values is not a numeric value, a "hole" is created in the series.
grProgrammingSeries described through programming.

<Details 1> can correspond to a series of numbers in the same character string, separated by ";".
grTableSeries filled from a WLanguage array.

<Details 1> corresponds to the name of the array. <Details 2> can be the index of the column (two-dimensional array) or the name of a member (array of structures).
grTableColumnSeries filled from a column of a Table control.

In this case, <Details 1> corresponds to the name of a column found in a Table control. 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.
<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.
Remarks
  • The Source property identifies the type of data source of a series of a chart (column of a Table control, List Box control, etc.).
  • The SourceDescription property gets the name of the element that corresponds to the data source of a series of a chart.
Component: wd290grf.dll
Minimum version required
  • Version 10
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 06/21/2023

Send a report | Local help