TreeMapItem.Value Property

Gets or sets the value of a tree map item.

Namespace: DevExpress.Xpf.TreeMap

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

Declaration

C#

public double Value { get; set; }

VB.NET

Public Property Value As Double

Property Value

Type	Description
Double	A Double value.

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 Value property.

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-implement-the-custom-tree-map-colorizer-t309141/CS/CustomColorizerSample/CustomColorizer.cs#L11

Color groupColor = Palette[group.GroupIndex % Palette.Count];
double proportion = (item.Value - group.MinValue) /
        (group.MaxValue - group.MinValue);

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

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

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

        Label="United States"
        Value="11384763"/>
<dxtm:TreeMapItem

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

<dxtm:TreeMapItem Label="United States"
                  Value="11384763"/>
<dxtm:TreeMapItem Label="Brazil"

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

<dxtm:TreeMapItem Label="United States"
                  Value="11384763"/>
<dxtm:TreeMapItem Label="Brazil"

VB.NET

how-to-implement-the-custom-tree-map-colorizer-t309141/VB/CustomColorizerSample/CustomColorizer.vb#L13

Dim groupColor As Color = Palette(group.GroupIndex Mod Palette.Count)
Dim proportion As Double = (item.Value - group.MinValue) / (group.MaxValue - group.MinValue)