TreeMapGroupDefinition.GroupDataMember Property

Gets or sets the name of a data member of the data source used to group tree map items generated from the data source.

Namespace: DevExpress.Xpf.TreeMap

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

Declaration

C#

public string GroupDataMember { get; set; }

VB.NET

Public Property GroupDataMember As String

Property Value

Type	Description
String	A String value, specifying the name of the data member.

Example

To provide flat data to the Tree Map, perform the following steps.

• Assign a new TreeMapFlatDataAdapter object to the TreeMapControl.DataAdapter property.
• Specify the adapter’s TreeMapFlatDataAdapter.DataSource, TreeMapFlatDataAdapter.LabelDataMember and TreeMapFlatDataAdapter.ValueDataMember properties.
• Optionally, to group automatically generated tree map items, add the TreeMapGroupDefinition to the TreeMapFlatDataAdapter.Groups collection, and specify the definition’s TreeMapGroupDefinition.GroupDataMember and TreeMapGroupDefinition.HeaderContentTemplate properties.

Note

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

MainWindow.xaml

<Window.Resources>
    <XmlDataProvider 
        x:Key="gdpDataSource" 
        Source="Data/top10gdp.xml"/>
    <DataTemplate 
        x:Key="headerTemplate">
        <Border 
            BorderBrush="#606060" 
            BorderThickness="1" 
            Margin="4,4,4,-4">
            <TextBlock 
                Padding="6,2,0,2"
                Text="{Binding Label}"
                Background="#808080"
                Foreground="White"/>
        </Border>
    </DataTemplate>
</Window.Resources>
<Grid>
    <dxtm:TreeMapControl>
        <dxtm:TreeMapControl.Colorizer>
            <dxtm:TreeMapPaletteColorizer>
                <dxtm:Office2016Palette/>
            </dxtm:TreeMapPaletteColorizer>
        </dxtm:TreeMapControl.Colorizer>
        <dxtm:TreeMapFlatDataAdapter 
            DataSource="{Binding Source={StaticResource gdpDataSource}}"
            DataMember="Country"
            LabelDataMember="Name"
            ValueDataMember="Gdp">
            <dxtm:TreeMapFlatDataAdapter.Groups>
                <dxtm:GroupDefinitionCollection>
                    <dxtm:TreeMapGroupDefinition 
                        GroupDataMember="SideOfWorld"
                        HeaderContentTemplate="{Binding Source={StaticResource headerTemplate}}"/>
                </dxtm:GroupDefinitionCollection>
            </dxtm:TreeMapFlatDataAdapter.Groups>
        </dxtm:TreeMapFlatDataAdapter>
    </dxtm:TreeMapControl>
</Grid>

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the GroupDataMember 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-provide-flat-data-to-the-treemap-t308588/CS/TreeMapFlatDataAdapterSample/MainWindow.xaml#L44

<dxtm:TreeMapGroupDefinition
    GroupDataMember="SideOfWorld"
    HeaderContentTemplate="{Binding Source={StaticResource headerTemplate}}"/>