In french: grSourceSérie
// 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")
// 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")
<Result> = grSourceSeries(<Chart name> , <Series number> , <Source> [, <Details 1> [... [, <Details N>]]])
- 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.
Only Chart controls are available.
<Series number>: Integer
Number of the affected series.
<Source>: Integer constant
Data source of the chart:
|grCallback||Series 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.
This constant is not available.
|grItem||Series 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.
|grListBox||Series 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.
|grProgramming||Series described through programming. |
<Details 1> can correspond to a series of numbers in the same character string, separated by ";".
|grTable||Series 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).
|grTableColumn||Series 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.
- 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.
This page is also available for…