grSunburstAddData (Function)

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 / WLanguage / WLanguage functions / Controls, pages and windows / Chart functions

Sunburst chart
Adding data into a chart

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

grSunburstAddData (Function)

In french: grSMNAjouteDonnée

Adds a data to a Sunburst chart.

Example

grSunburstAddData(GRF_Graphe, "Europe" + TAB + "France" + TAB + "Montpellier", 320000)
grSunburstAddData(GRF_Graphe, "Europe" + TAB + "France" + TAB + "Paris", 789000)
grSunburstAddData(GRF_Graphe, "Europe" + TAB + "France", 1109000) 
grSunburstAddData(GRF_Graphe, "Europe" + TAB + "Belgique", 900000)
grSunburstAddData(GRF_Graphe, "Asie", 250000)
grDraw(GRF_Graphe)

Syntax

grSunburstAddData(<Chart name> , <Section path> , <Value>)

<Chart name>: Control name or character string

Name of the chart to be used. This name corresponds to:
the name of the chart defined programmatically with grCreate.
the name of the Chart control in the window, page or report editor.
In pages, only "Interactive chart" controls are available for Sunburst charts.

<Section path>: Character string

Full path of the section that will be added into the chart. This parameter has the following format:
"<Name of base level>" + TAB + ["<Name of 1st level>" + TAB + ...
["<Name of last level>" + TAB + [...]]]"<Section name>"
This path defines the position of the data by specifying the its different hierarchical levels.
For example, if the path contains "Europe + TAB + France + TAB + Montpellier", the data will be added on the third level of the chart below the "Europe\France\Montpellier" categories.

<Value>: Real

Value of the added part. This value must not be negative.

Remarks

Sunburst chart

If a level does not contain its own value, its value will be calculated by adding the values of sub-levels.
If the sum of data for the sub-levels of a specific level exceeds the value of this level, an error will be returned when drawing the chart.
The color of the sublevels is calculated automatically: this color is the same shade as the color of the main level, but paler.

Adding data into a chart

grAddData is used to add data into a chart (pie, column, ...)

Depending on the type of chart, specific functions can also be used to add data:

For stock charts, it is recommended to use grStockAddData.
For Heatmap charts, it is recommended to use grHMAddData.
For Scatter charts, it is recommended to use grScatterAddDataXY.
For Surface charts, it is recommended to use grSurfaceAddData.

Reminder: To add a value to a data item on a graph, use the grIncreaseData function.

Business / UI classification: Neutral code

Component: wd300grf.dll