addDataGroup([ name ])

Open a new data group.

Currently, only stacked bar layers support data groups for creating "multi-stacked" bars.

In a normal stacked bar layer, all data sets are stacked on top of one another, creating one stacked bar per x-axis position. If data grouping is used, data sets within the same data group with be stacked up. So there may be multiple stacked bars in each x-axis position. These stacked bars are drawn side by side.

When you add a data set using Layer.addDataSet, the data set will belong to the current data group. The addDataGroup method can be used to open a new data group, so that subsequent data sets will belong to that new group.

You may associate a name with a data group. The name can then be used in data labels or image maps to identify the data group.

None