TreeMapItem Class

An item of a tree map.

Namespace: DevExpress.Xpf.TreeMap

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

NuGet Package: DevExpress.Wpf.TreeMap

Declaration

C#

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

VB.NET

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

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.

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>

Implements

ITreeMapLayoutItem

Inheritance

Object

DispatcherObject

DependencyObject

Freezable

TreeMapDependencyObject

TreeMapItem