Xceed Toolkit Plus for WPF v5.0 Documentation
Xceed.Wpf.DataGrid Assembly / Xceed.Wpf.DataGrid Namespace / DataGridControl Class / DefaultGroupConfiguration Property
Example


In This Topic
    DefaultGroupConfiguration Property (DataGridControl)
    In This Topic
    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
    '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.
    <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

    See Also