TreeMapItem Class

An item of a tree map.

Namespace: DevExpress.Xpf.TreeMap

Assembly: DevExpress.Xpf.TreeMap.v20.2.dll

NuGet Packages: DevExpress.WindowsDesktop.Wpf.TreeMap, DevExpress.Wpf.TreeMap

Declaration

C#

public class TreeMapItem :
    TreeMapDependencyObject,
    INotifyPropertyChanged,
    IHierarchicalItem,
    ITreeMapLayoutItem,
    IPatternHolder,
    IToolTipItem,
    ISelectableItem

VB.NET

Public Class TreeMapItem
    Inherits TreeMapDependencyObject
    Implements INotifyPropertyChanged,
               IHierarchicalItem,
               ITreeMapLayoutItem,
               IPatternHolder,
               IToolTipItem,
               ISelectableItem

Related API Members

The following members return TreeMapItem objects:

• TreeMapHitInfo.TreeMapItem

Remarks

An instance of the TreeMapItem class represents a data value that is used to plot tree map diagram.

The TreeMapItem class introduces the following properties required to specify the tree map item.

• TreeMapItem.Label - the value label used to identify it.
• TreeMapItem.Value - the value to visualize.
• TreeMapItem.Children - allows you to specify the child items. This can be required to group items.

In addition to the properties above, this class contains the TreeMapItem.Background and TreeMapItem.Foreground properties specifying the appearance of tree map item.

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.

View Example

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 TreeMapItem 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.

XAML

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

<dxtm:TreeMapItemStorage>
    <dxtm:TreeMapItem Label="Americas">
        <dxtm:TreeMapItem

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

<dxtm:TreeMapItemStorage>
    <dxtm:TreeMapItem Label="Americas">
        <dxtm:TreeMapItem Label="United States" Value="17.418"/>

how-to-color-tree-map-items-using-the-range-colorizer-t307568/CS/TreeMapRangeColorizerSample/MainWindow.xaml#L26

<dxtm:TreeMapItemStorage>
    <dxtm:TreeMapItem Label="Americas">
        <dxtm:TreeMapItem

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

<dxtm:TreeMapItemStorage>
    <dxtm:TreeMapItem Label="Americas">
        <dxtm:TreeMapItem Label="United States"

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

<dxtm:TreeMapItemStorage>
    <dxtm:TreeMapItem Label="Americas">
        <dxtm:TreeMapItem Label="United States"

Implements

ITreeMapLayoutItem

Inheritance

Object

DispatcherObject

DependencyObject

Freezable

TreeMapDependencyObject

TreeMapItem