Skip to main content
A newer version of this page is available. .

SunburstControl Class

Displays an interactive Sunburst chart.

Namespace: DevExpress.XtraTreeMap

Assembly: DevExpress.XtraTreeMap.v19.2.dll

Declaration

[ComVisible(true)]
[ToolboxBitmap(typeof(ToolboxIconsRoot), "SunburstControl")]
[Docking(DockingBehavior.Ask)]
public class SunburstControl :
    HierarchicalChartControlBase

Remarks

The Sunburst control provides a set of data adapters that allow you to generate items based on Flat Data Tables and Hierarchical Data Sets. You can also populate sunburst item storage manually. Sunburst allows you to specify how to group items on each level of the hierarchy.

You can use the built-in coloring algorithms to specify the sunburst items colors.

The Sunburst control supports multiple item selection. You can operate with selected items and use them as another control’s data source.

Sunburst provides various highlighting modes. End users can highlight the following elements at once:

  • A single item
  • An item and its child items
  • An item and its parent items

The following image demonstrates a SunburstControl.

sunburst-flat-data-example

To get acquainted with using the SunburstControl, please refer to the Getting Started section.

Example

This example demonstrates how to visualize flat data using the SunburstControl.

Create a SunburstFlatDataAdapter object and assign it to the SunburstControl.DataAdapter property to provide flat data to the Sunburst. Then, specify the adapter’s SunburstFlatDataAdapter.DataSource, SunburstFlatDataAdapter.LabelDataMember and SunburstFlatDataAdapter.ValueDataMember to define data source members that should be used to generate sunburst items. Add data members to the SunburstFlatDataAdapter.GroupDataMembers collection to specify how to group the sunburst’s items.

Note

A complete sample project is available at How to: provide flat data to Sunburst.

private void OnLoad(object sender, EventArgs e) {
    SunburstFlatDataAdapter dataAdapter = new SunburstFlatDataAdapter();            
    dataAdapter.ValueDataMember = "Annual";
    dataAdapter.LabelDataMember = "Product";
    dataAdapter.GroupDataMembers.AddRange(new string[] { "Category", "Country" });
    dataAdapter.DataSource = CreateProductInfos();
    sunburstControl.DataAdapter = dataAdapter;
}
See Also