Xceed Logo
Shop
Xceed Toolkit Plus for WPF v5.1 Documentation
Xceed.Wpf.DataGrid.Toolkit 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 through its corresponding DefaultGroupConfiguration property.

    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>
    Supported Frameworks

    .NET: net5.0, net5.0-windows, net6.0, net6.0-macos, net6.0-windows, net7.0, net7.0-macos, net7.0-windows, net8.0, net8.0-browser, net8.0-macos, net8.0-windows, net9.0, net9.0-browser, net9.0-macos, net9.0-windows, net10.0, net10.0-browser, net10.0-macos, net10.0-windows.

    .NET Framework: net40, net403, net45, net451, net452, net46, net461, net462, net463, net47, net471, net472, net48, net481.

    See Also

    Reference

    DataGridControl Class
    DataGridControl Members

    Send Feedback