DefaultGroupConfiguration Property (DataGridControl)

Gets or sets the default configuration that will be applied to any groups in the grid for which an explicit group configuration is not provided.

Syntax

Visual Basic
C#

'Declaration
 
Public Property DefaultGroupConfiguration As GroupConfiguration

'Usage
 
Dim instance As DataGridControl

Dim value As GroupConfiguration

 

instance.DefaultGroupConfiguration = value

 

value = instance.DefaultGroupConfiguration

public GroupConfiguration DefaultGroupConfiguration {get; set;}

Property Value

The GroupConfiguration that will be applied to any groups in the grid for which an explicit group configuration is not provided.

Remarks

Default group configurations will be applied to master groups in the case where neither a column nor group description provide a group configuration, and when a group-configuration selector returns a null reference (Nothing in Visual Basic) (no group configuration was selected).

A default group configuration can be provided to a grid or detail configuration through their corresponding DefaultGroupConfiguration properties.

If a default group configuration is not explicitly provided, the theme's built-in group configuration will be used.

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 default group configuration.

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.DefaultGroupConfiguration>

        <xcdg:GroupConfiguration>

          <xcdg:GroupConfiguration.Footers>

            <DataTemplate>

              <xcdg:InsertionRow/>

            </DataTemplate>

          </xcdg:GroupConfiguration.Footers>

        </xcdg:GroupConfiguration>

      </xcdg:DataGridControl.DefaultGroupConfiguration>      

    </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