TreeMapItemStorage Class

Stores a collection of tree map items and provides them to a tree map control.

Namespace: DevExpress.Xpf.TreeMap

Assembly: DevExpress.Xpf.TreeMap.v19.1.dll

Declaration

C#

public class TreeMapItemStorage :
    TreeMapDataAdapterBase

VB.NET

Public Class TreeMapItemStorage
    Inherits TreeMapDataAdapterBase

Remarks

This class introduces the TreeMapItemStorage.Items property, allowing you to specify the collection of tree map items.

Example

To manually provide data to the TreeMap, perform the following actions.

• Assign a newly created TreeMapItemStorage object to the TreeMapControl.DataAdapter property.

• Create several TreeMapItem objects, specify their TreeMapItem.Label and TreeMapItem.Value propeties, then add items to the TreeMapItemStorage.Items collection.

  Note

  Note that a tree map item represents a group if its TreeMapItem.Children collection contains child items.

Note

A complete sample project is available at https://github.com/DevExpress-Examples/how-to-manually-provide-data-to-the-treemap-t308324.

MainWindow.xaml

<dxtm:TreeMapControl>
    <dxtm:TreeMapControl.Colorizer>
        <dxtm:TreeMapPaletteColorizer>
            <dxtm:Office2016Palette/>
        </dxtm:TreeMapPaletteColorizer>
    </dxtm:TreeMapControl.Colorizer>
    <dxtm:TreeMapItemStorage>
        <dxtm:TreeMapItem Label="Americas">
            <dxtm:TreeMapItem Label="United States"
                              Value="11384763"/>
            <dxtm:TreeMapItem Label="Brazil"
                              Value="1799612"/>
            <dxtm:TreeMapItem Label="Canada"
                              Value="1572781"/>
        </dxtm:TreeMapItem>
        <dxtm:TreeMapItem Label="Europe">
            <dxtm:TreeMapItem Label="Germany"
                              Value="3371003"/>
            <dxtm:TreeMapItem Label="United Kingdom"
                              Value="2582021"/>
            <dxtm:TreeMapItem Label="France"
                              Value="2422649"/>
            <dxtm:TreeMapItem Label="Italy"
                              Value="1809047"/>
        </dxtm:TreeMapItem>
        <dxtm:TreeMapItem Label="Asia">
            <dxtm:TreeMapItem Label="China"
                              Value="17968195"/>
            <dxtm:TreeMapItem Label="Japan"
                              Value="4116242"/>
            <dxtm:TreeMapItem Label="India"
                              Value="2864903"/>
        </dxtm:TreeMapItem>
    </dxtm:TreeMapItemStorage>
</dxtm:TreeMapControl>

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the TreeMapItemStorage class.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-change-the-layout-algorithm-used-by-treemap-t308988/CS/TreeMapLayoutAlgorithmCustomizationSample/MainWindow.xaml#L19

</dxtm:TreeMapControl.Colorizer>
<dxtm:TreeMapItemStorage>
    <dxtm:TreeMapItem Label="Americas">

how-to-color-tree-map-items-using-gradient-colorizer-t307515/CS/TreeMapGradientColorizerSample/MainWindow.xaml#L19

<!--endregion #TreeMapGradientColorizer-->
<dxtm:TreeMapItemStorage>
    <dxtm:TreeMapItem Label="Americas">

how-to-manually-provide-data-to-the-treemap-t308324/CS/TreeMapItemStorageSample/MainWindow.xaml#L15

</dxtm:TreeMapControl.Colorizer>
<dxtm:TreeMapItemStorage>
    <dxtm:TreeMapItem Label="Americas">

how-to-implement-the-custom-tree-map-colorizer-t309141/CS/CustomColorizerSample/MainWindow.xaml#L19

</dxtm:TreeMapControl.Colorizer>
<dxtm:TreeMapItemStorage>
    <dxtm:TreeMapItem Label="Americas">

how-to-configure-tree-map-end-user-interaction-permissions-t309113/CS/TreeMapHighlightingSelectionSample/MainWindow.xaml#L24

</dxtm:TreeMapControl.Colorizer>
<dxtm:TreeMapItemStorage>
    <dxtm:TreeMapItem Label="Americas">

Inheritance

Object

DispatcherObject

DependencyObject

Freezable

TreeMapDependencyObject

TreeMapDataAdapterBase

TreeMapItemStorage

Extension Methods

GetErrorOperationCommands(Position)

GetErrorOperationCommands(Int32)

GetErrorOperationCommands(Point)