GroupByControl Class
See Also  Members   Example 
Xceed.Wpf.DataGrid Assembly > Xceed.Wpf.DataGrid Namespace : GroupByControl Class

Represents a control that displays information about how the data items in a grid or detail are grouped and sorted as well as allows the end user to change how the items are grouped and sorted.

Syntax

Visual Basic (Declaration) 
Public Class GroupByControl 
   Inherits ItemsControl
   Implements IGeneratorHost, ISupportInitialize, IFrameworkInputElement, IInputElement, IAddChild, IHaveResources, IAnimatable, DUCE.IResource, IDropTarget 
C# 
public class GroupByControl : ItemsControl, IGeneratorHost, ISupportInitialize, IFrameworkInputElement, IInputElement, IAddChild, IHaveResources, IAnimatable, DUCE.IResource, IDropTarget 

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 recreate the default card-view header, which contains a ColumnManagerRow to the right of a GroupByControl.
XAMLCopy Code
<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}"/> 
  </Grid.Resources> 
  <xcdg:DataGridControl x:Name="OrdersGrid" 
                        ItemsSource="{Binding Source={StaticResource cvs_orders}}"> 
    <xcdg:DataGridControl.View> 
      <xcdg:CardView UseDefaultHeadersFooters="False"> 
        <xcdg:CardView.FixedHeaders> 
 
         <DataTemplate> 
           <DockPanel> 
             <!-- OneWay binding is used because we want the ColumnManagerRow's height to 
                  follow what is defined by the GroupByControl. A FallbackValue 
                  is specified so the initial measure pass has an acceptable minimal 
                  value.--> 
             <xcdg:ColumnManagerRow DockPanel.Dock="Right" 
                                    Height="{Binding ElementName=groupByControl, 
                                                     Path=ActualHeight, 
                                                     Mode=OneWay, 
                                                     FallbackValue=60}"/> 
             <xcdg:GroupByControl x:Name="groupByControl"/> 
           </DockPanel> 
         </DataTemplate> 
        </xcdg:CardView.FixedHeaders> 
      </xcdg:CardView> 
    </xcdg:DataGridControl.View> 
  </xcdg:DataGridControl> 
</Grid>
The following example demonstrates how to provide an implicit style targeting the HierarchicalGroupByControl class that changes the value of the NoGroupContent property to display Hello World rather than Drag a column header hear to group by that column..
XAMLCopy Code
<Grid xmlns:xcdg="http://schemas.xceed.com/wpf/xaml/datagrid" 
 xmlns:local="clr-namespace:Xceed.Wpf.Documentation"> 
  <Grid.Resources> 
   <xcdg:DataGridCollectionViewSource x:Key="cvs_orders" 
                                      Source="{Binding Source={x:Static Application.Current}, 
                                                Path=Orders}"/> 
   <Style TargetType="{x:Type xcdg:HierarchicalGroupByControl}"> 
      <Setter Property="NoGroupContent" 
              Value="Hello World" /> 
   </Style> 
  </Grid.Resources> 
  <xcdg:DataGridControl x:Name="OrdersGrid" 
                      ItemsSource="{Binding Source={StaticResource cvs_orders}}"/> 
  
</Grid>

Inheritance Hierarchy

System.Object
   System.Windows.Threading.DispatcherObject
      System.Windows.DependencyObject
         System.Windows.Media.Visual
            System.Windows.UIElement
               System.Windows.FrameworkElement
                  System.Windows.Controls.Control
                     System.Windows.Controls.ItemsControl
                        Xceed.Wpf.DataGrid.GroupByControl

Requirements

Supported Operating Systems: Windows Server 2003 Service Pack 1; Windows Vista; Windows XP Service Pack 2

See Also