GroupConfigurationSelector Property (DataGridControl)

Gets or sets a group-configuration selector that will be used to select the appropriate configuration for a master group based on its information and/or content.

Syntax

Visual Basic
C#

'Declaration
 
Public Property GroupConfigurationSelector As GroupConfigurationSelector

'Usage
 
Dim instance As DataGridControl

Dim value As GroupConfigurationSelector

 

instance.GroupConfigurationSelector = value

 

value = instance.GroupConfigurationSelector

public GroupConfigurationSelector GroupConfigurationSelector {get; set;}

Property Value

A GroupConfigurationSelector that will be used to select the appropriate configuration for a master group based on its information and/or content.

Remarks

Unlike a default group configuration, which applies to all groups, group-configuration selectors, such as the built-in FieldNameGroupConfigurationSelector and LevelGroupConfigurationSelector, can be used to select the appropriate configuration for a group based on its information and/or content using their respective FieldNameGroupConfigurationSelectorItem and LevelGroupConfigurationSelectorItem, which provide a group configuration and indicate for what specific field name or level that configuration applies.

Example

All examples in this topic assume that the grid is bound to the Orders table of the Northwind database, unless stated otherwise.

The following example demonstrates how to provide a FieldNameGroupConfigurationSelector that will apply the defined group configuration to all groups that are created from the values of the column corresponding to the specified field name.

XAML

<Grid xmlns:xcdg="http://schemas.xceed.com/wpf/xaml/datagrid">

  <Grid.Resources>

    <xcdg:DataGridCollectionViewSource x:Key="cvs_orders"

                                       Source="{Binding Source={x:Static Application.Current},

                                                        Path=Orders}">

      <xcdg:DataGridCollectionViewSource.GroupDescriptions>

        <xcdg:DataGridGroupDescription PropertyName="ShipCountry" />

        <xcdg:DataGridGroupDescription PropertyName="ShipCity" />

      </xcdg:DataGridCollectionViewSource.GroupDescriptions>

    </xcdg:DataGridCollectionViewSource>

  </Grid.Resources>

  <xcdg:DataGridControl x:Name="OrdersGrid"

                        ItemsSource="{Binding Source={StaticResource cvs_orders}}">

    <xcdg:DataGridControl.GroupConfigurationSelector>

      <xcdg:FieldNameGroupConfigurationSelector>

        <xcdg:FieldNameGroupConfigurationSelectorItem FieldName="ShipCity">

          <xcdg:FieldNameGroupConfigurationSelectorItem.GroupConfiguration>

            <xcdg:GroupConfiguration>

              <xcdg:GroupConfiguration.Footers>

                <DataTemplate>

                  <xcdg:InsertionRow />

                </DataTemplate>

              </xcdg:GroupConfiguration.Footers>

            </xcdg:GroupConfiguration>

          </xcdg:FieldNameGroupConfigurationSelectorItem.GroupConfiguration>                 

        </xcdg:FieldNameGroupConfigurationSelectorItem>

      </xcdg:FieldNameGroupConfigurationSelector>

    </xcdg:DataGridControl.GroupConfigurationSelector>

  </xcdg:DataGridControl>

</Grid>

Requirements

Target Platforms: Windows 11, Windows 10, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

DataGridControl Class
DataGridControl Members