TreeMapItem.Label Property

Gets or sets the label of a tree map item.

Namespace: DevExpress.Xpf.TreeMap

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

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

Declaration

C#

public string Label { get; set; }

VB.NET

Public Property Label As String

Property Value

Type	Description
String	A String value, representing the label of a 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 Label 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.

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"