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

See also

<Chart>.SourceSeries (Function)

In french: <Graphe>.SourceSérie

Defines the source of a series.

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 17 and later

This function is now available for iPhone/iPad applications.

New in version 17

This function is now available for iPhone/iPad applications.

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 19 and later

This function is now available for Android applications.

New in version 19

This function is now available for Android applications.

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

// Chart control filled from a Table control column
IF CHART_Chart1.SourceSeries(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 a SQL query
MyQuery is Data Source

MySQLCode is string = QRY_Query1..SQLCode
HExecuteQuery(MyQuery, hQueryDefault, MySQLCode)
CHART_Chart1.SourceSeries(1, grItem, "MyQuery", "TotalBT")
CHART_Chart1.Draw()

CASE ERROR:
Error(HErrorInfo())

Syntax

<Result> = <Chart control>.grSourceSeries(<Series number> , <Source> [, <Details 1> [... [, <Details N>]]])

<Result>: Boolean

True if the source was defined,
False otherwise. To find out the error details, use ErrorInfo.

<Chart control>: Control name

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

<Series number>: Integer

Number of the affected series.

<Source>: Integer constant

Data source of the chart:
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.
This constant is not available.
Versions 22 and later
This constant is now available.
New in version 22
This constant is now available.
This constant is now available.
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 control>, <Series number>,
<Index in series>)

The procedure returns the requested number. To specify the end of the series, the procedure must return False.
This constant is not available.
grListBox Series 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.
grProgramming Series described by programming.

<Details 1> can correspond to a series of numbers in the same character string, separated by ";".
grItem Series 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.
grTable Series 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.

Remarks

..Source is used to find out the type of data source of a chart series (column, list, etc.).
..SourceDescription is used to find out the name of the element that corresponds to the data source of a chart series

Component : wd240grf.dll