Filling a Chart control

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / Developing an application or website / Controls, windows and pages / Controls: Available types / Chart control

Overview
Chart populated programmatically
Remarks
Special case
Chart control in a window or in a page based on a Table control built by BuildBrowsingTable

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Filling a Chart control

Overview

The data that will be displayed in the Chart control can come from:

a data file item or a query.
a column of a Table control found in the current window or page.
a List Box control found in the current window or page.
a WLanguage array.
data specified in the description window of the control or programmatically.
a control of the current report (only for a report).

The mode for filling the chart is specified in the wizard for control creation and in the control description window ("Series" tab).

Chart populated programmatically

The programming required to fill the chart is performed by the following functions:


grAddData	Adds a data into a chart.
grHMAddData	Adds a data into a Heatmap chart.
grIncreaseData	Adds a value to a data in a chart.
grScatterAddDataXY	Adds a data into a "Scatter" chart.
grStockAddData	Adds data into a stock chart (candlestick, barcharts or minmax).
grSunburstAddData	Adds a data to a Sunburst chart.
grSurfaceAddData	Adds a data into a Surface chart.

For example:

Chart control in a window or page:
The "CHART_MySalary" Chart control is used to view the evolution of a salary over the last four years in a Line chart.
The "EDT_Salary1", "EDT_Salary2", "EDT_Salary3" and "EDT_Salary4" edit controls are used to type the salary for the corresponding year.
In this example, write the following code in the "Initialization" event of the Chart control:
```
// Add data into the chart
grAddData(CHART_MySalary, 1, EDT_Salary1)
grAddData(CHART_MySalary, 1, EDT_Salary2)
grAddData(CHART_MySalary, 1, EDT_Salary3)
grAddData(CHART_MySalary, 1, EDT_Salary4)
```
Chart control in a state:
The "RPT_MyReport" report prints the details (last name, first name, turnover) of the 10 best customers.
The "CHART_MyChart" chart displays the turnover of each customer in a pie chart.
In this example, write the following code in the "Before printing" event of the Body block:
```
// Add data into the chart
grAddData(CHART_MyChart, 1, MySource.Turnover)
```

Remarks

If the fill mode is automatic, we advise you not to program the chart filling (with grAddData, grScatterAddDataXY, grStockAddData and grIncreaseData).
The chart is automatically created by the window editor, page editor or report editor. There is no need to use grCreate to create it.
The aspect of the chart and/or the display of text in the chart can be modified:
- in the chart description ("Description" in the context menu of the control). For more details, see Chart control: Features in the editor.
- via the functions for chart management.

Special case

Chart control in a window or in a page based on a Table control built by BuildBrowsingTable

If you are creating a new chart whose source is a Table control filled by BuildBrowsingTable from a query, you must specify that the columns correspond to _COL1, _COL2, ...

You can also use grSourceSeries to modify the source of the series.