WPF DataGrid常用属性记录

组件常用方法：

BeginEdit：使DataGrid进入编辑状态。

CancelEdit：取消DataGrid的编辑状态。

CollapseRowGroup：闭合DataGrid的行分组。

CommitEdit：确认DataGrid的编辑完成。

ExpandRowGroup：展开DataGrid的行分组。

GetGroupFromItem：从具体Item中得到分组。

ScrollIntoView：滚动DataGrid视图。

 

组件常用属性：

AlternatingRowBackground：获取或设置一个笔刷用来描绘DataGrid奇数行的背景。

AreRowDetailsFrozen：获取或设置一个值用来判断是否冻结每行内容的详细信息。

AreRowGroupHeadersFrozen：获取或设置一个值用来判断是否冻结分组行的头部。

AutoGenerateColumns：获取或设置一个值用来判断是否允许自动生成表列。

CanUserReorderColumns：获取或设置一个值用来判断是否允许用户重新排列表列的位置。

CanUserSortColumns：获取或设置一个值用来判断是否允许用户按列对表中内容进行排序。

CellStyle：获取或设置单元格的样式。

ColumnHeaderHeight：获取或设置列头的高度。

ColumnHeaderStyle：获取或设置列头的样式。

Columns：获取组件中包含所有列的集合。

ColumnWidth：获取或设置列宽。

CurrentColumn：获取或设置包含当前单元格的列。

CurrentItem：获取包含当前单元格且与行绑定的数据项。

DragIndicatorStyle：获取或设置当拖曳列头时的样式。

DropLocationIndicatorStyle：获取或设置呈现列头时的样式。

FrozenColumnCount：获取或设置冻结列的个数。

GridLinesVisibility：获取或设置网格线的显示形式。

HeadersVisibility：获取或设置行头及列头的显示形式。

HorizontalGridLinesBrush：获取或设置水平网格线的笔刷。

HorizontalScrollBarVisibility：获取或设置水平滚动条的显示样式。

IsReadOnly：获取或设置DataGrid是否为只读。

MaxColumnWidth：获取或设置DataGrid的最大列宽。

MinColumnWidth：获取或设置DataGrid的最小列宽。

RowBackground：获取或设置用于填充行背景的笔刷。

RowDetailsTemplate：获取或设置被用于显示行详细部分的内容的模板。

RowDetailsVisibilityMode：获取或设置一个值用以判定行详细部分是否显示。

RowGroupHeaderStyles：获取呈现行分组头部的样式。

RowHeaderStyle：获取或设置呈现行头的样式。

RowHeaderWidth：获取或设置行头的宽度。

RowHeight：获取或设置每行的高度。

RowStyle：获取或设置呈现行时的样式。

SelectedIndex：获取或设置当前选中部分的索引值。

SelectedItem：获取或设置与当前被选中行绑定的数据项。

SelectedItems：获取与当前被选中的各行绑定的数据项们的列表（List）。

SelectionMode：获取或设置DataGrid的选取模式。

VerticalGridLinesBrush：获取或设置垂直网格线的笔刷。

VerticalScrollBarVisibility：获取或设置垂直滚动条的显示样式。

 

组件常用事件：

BeginningEdit：发生于一个单元格或行进入编辑模式之前。

CellEditEnded：发生于一个单元格编辑已被确认或取消。

CellEditEnding：发生于一个单元格正在结束编辑时。

CurrentCellChanged：发生于一个单元格成为当前单元格时。

PreparingCellForEdit：发生于在DataGridTemplateColumn下的单元格进入编辑模式时。

SelectionChanged：发生于当SelectedItem或SelectedItems属性值改变时。

 

1.DataGrid隔行变色

RowBackground和AlternatingRowBackground设置一排交替行的背景。AlternationCount是将用于行的样式或颜色的总数

<DataGrid Name="dg" RowHeaderWidth="50" AlternationCount="2" AlternatingRowBackground="#F4F4F4"  AutoGenerateColumns="False" Grid.Row="1" HeadersVisibility="All"  Margin="4" >
                    <DataGrid.Columns>
                        <DataGridTextColumn Binding="{Binding Name}" Header="Name"/>
                    </DataGrid.Columns>
                </DataGrid>

如果设置AlternatingRowBackground刷，将被分配到行，其中（rownumber％AlternationIdex）== 1

<Style x:Key="DataGridDemoRowStyle"  
TargetType="{x:Type Custom:DataGridRow}">
<Style.Triggers>
<Trigger Property="AlternationIndex" Value="2" >
 <Setter Property="Background" Value="{StaticResource RowBackgroundAlternationIndex2Brush}" />
</Trigger>
<Trigger Property="AlternationIndex" Value="3">
<Setter Property="Background" Value="{StaticResource RowBackgroundAlternationIndex3Brush}" />
</Trigger>
</Style.Triggers>
</Style>

请注意对于上面的样式，有目的的，我只覆盖AlternationIndex= 2,3。对于AlternationIndex= 0时，它使用RowBackground。
对于AlternationIndex= 1，它使用从DataGrid中AlternatingRowBackground的。

 

2.DataGrid的ErrorTemplate属性

<Style x:Key="{x:Type DataGridRow}" TargetType="{x:Type DataGridRow}">
        <Setter Property="Background" Value="Transparent" />
        <Setter Property="SnapsToDevicePixels" Value="true"/>
        <Setter Property="Validation.ErrorTemplate" Value="{x:Null}" />
        <Setter Property="ValidationErrorTemplate">
            <Setter.Value>
                <ControlTemplate>
                    <TextBlock Margin="2,0,0,0" VerticalAlignment="Center" Foreground="#FFdc000c" Text="!" />
                </ControlTemplate>
            </Setter.Value>
        </Setter>
</Style>

上面这段XAML设置了DataGridRow的ValidationErrorTemplate为RowHeader通过模板

<Style x:Key="{x:Type DataGridRowHeader}" TargetType="{x:Type DataGridRowHeader}">
        <Setter Property="Background" Value="{DynamicResource DataGridHeaderBackground}" />
        <Setter Property="Foreground" Value="{DynamicResource DataGridHeaderForeground}" />
        <Setter Property="BorderBrush" Value="{DynamicResource DataGridGridLines}" />
        <Setter Property="BorderThickness" Value="0,0,0,1" />
        <Setter Property="Width" Value="16"/>
        <Setter Property="Template">
            <Setter.Value>
                <ControlTemplate TargetType="{x:Type DataGridRowHeader}">
                    <Grid>
                        <Border Background="{TemplateBinding Background}"
                                BorderBrush="{TemplateBinding BorderBrush}"
                                BorderThickness="{TemplateBinding BorderThickness}"
                                Padding ="{TemplateBinding Padding}">

                            <StackPanel Orientation="Horizontal">
                                <ContentPresenter SnapsToDevicePixels="{TemplateBinding SnapsToDevicePixels}" VerticalAlignment="Center"/>
                                <Control SnapsToDevicePixels="false"
                                         Visibility="{Binding RelativeSource={RelativeSource AncestorType={x:Type DataGridRow}}, Path=(Validation.HasError), Converter={StaticResource BooleanToVisibilityConverter}}"
                                         Template="{Binding RelativeSource={RelativeSource AncestorType={x:Type DataGridRow}}, Path=ValidationErrorTemplate}" />
                            </StackPanel>
                        </Border>
                        <Thumb x:Name="PART_TopHeaderGripper"
                               VerticalAlignment="Top"
                               Style="{StaticResource RowHeaderGripperStyle}"/>
                        <Thumb x:Name="PART_BottomHeaderGripper"
                               VerticalAlignment="Bottom"
                               Style="{StaticResource RowHeaderGripperStyle}"/>
                    </Grid>
                </ControlTemplate>
            </Setter.Value>
        </Setter>

        <Style.Triggers>
            <Trigger Property="IsMouseOver" Value="True">
                <Setter Property="Background" Value="{DynamicResource DataGridHeaderBackgroundHover}" />
                <Setter Property="Foreground" Value="{DynamicResource DataGridHeaderForegroundHover}" />
            </Trigger>
            <Trigger Property="IsPressed" Value="True">
                <Setter Property="Background" Value="{DynamicResource DataGridHeaderBackgroundPressed}" />
                <Setter Property="Foreground" Value="{DynamicResource DataGridHeaderForegroundPressed}" />
            </Trigger>
            <Trigger Property="IsRowSelected" Value="True">
                <Setter Property="Background" Value="{DynamicResource DataGridHeaderBackgroundSelected}" />
                <Setter Property="Foreground" Value="{DynamicResource DataGridHeaderForegroundSelected}" />
            </Trigger>
        </Style.Triggers>
    </Style>

主对于错误验证主要是 当有错误的时候Control显示，并获取上面设置的DataGridRow的错误验证模板为Control的模板,当没有错误时就隐藏作为验证显示的Control

3.DataGrid 视图（排序、过滤、分组）

CollectionView介绍

事实上当你将后台数据列表绑定到一个列表控件时,WPF为了默默地在数据列表和列表控件之间增加了层称为CollectionView(列表视图)的东西,其支持很多高级操作,比如排序,分组,过滤等.这样我们就可以将这个过程分成3个部分来看:数据列表(维持着后台数据),列表视图(维持着一些附加状态,比如"当前项","排序"等),列表控件(负责对CollectionView的呈现,而不是对Collection)

CollectionView cv = new CollectionView(myList); 2 3 this.listBox.ItemsSource = cv; 

CollectionViewSource介绍

CollectionViewSource是CollectionView的一个XAML代理,意思就是说CollectionView不能在XAML中使用,如果希望在XML将CollectionView绑定到某个列表控件,那么请使用CollectionViewSource.它与CollectionView的基本关系是"HAS A". CollectionViewSource拥有一个CollectionView类型的View属性来指定其对应的CollectionView对象,与之对应的,其还有一个Source属性,来指明数据来源.一个简单的流程是:将数据列表绑定到CollectionViewSource的Source属性,然后将列表控件的ItemsSource属性绑定到CollectionViewSource的View属性.为什么不直接将列表控件的ItemSource属性绑定到数据列表呢,这取决于你是否需要查找到该CollectionViewSource进而查找到其View来进行视图操作(比如排序,导航等).这可能说得有些混乱了.看看下面的例子:

 

<Window.Resources>

         <XmlDataProvider x:Key="Employees" XPath="/Employees/*">
             <x:XData>
                 <Employees xmlns="">
                     <Employee Name="Terry Adams" Type="FTE" EmployeeNumber="1" />
                     <Employee Name="Claire O&apos;Donnell" Type="FTE" EmployeeNumber="12345" />
                     <Employee Name="Palle Peterson" Type="FTE" EmployeeNumber="5678" />
                     <Employee Name="Amy E. Alberts" Type="CSG" EmployeeNumber="99222" />
                     <Employee Name="Stefan Hesse" Type="Vendor" EmployeeNumber="-" />
                 </Employees>
             </x:XData>
         </XmlDataProvider>

         <DataTemplate  DataType="Employee">
             <TextBlock Text="{Binding XPath=@Name}" />
         </DataTemplate>
         
     </Window.Resources>

     <StackPanel>
         <ListBox ItemsSource="{Binding Source={StaticResource Employees}}"/>
     </StackPanel>

 

　　上面的例子中,我们按照传统的方式,将ListBox的ItemsSource绑定到一个XMLDataProvider上,工作得很好,后来我们发现WPF中可以利用CollectionView来实现列表排序,当然这种排序我们希望仅仅是在表现层,所以我们决定我XAML来做.当在实际改造这段代码的过程中,我们伤透了脑子,因为要在XAML中为我们的数据找到CollectionView对象并非易事.

 

　　事实上,我们仅仅需要改变一下数据绑定的流程就可以了.我们将数据与CollectionViewSource关联,然后CollectionViewSource与列表控件相关联,然后我们就可以在CollectionViewSource插入我们任何想要的排序方式了.

 

<Window.Resources>

         <XmlDataProvider x:Key="Employees" XPath="/Employees/*">
             <x:XData>
                 <Employees xmlns="">
                     <Employee Name="Terry Adams" Type="FTE" EmployeeNumber="1" />
                     <Employee Name="Claire O&apos;Donnell" Type="FTE" EmployeeNumber="12345" />
                     <Employee Name="Palle Peterson" Type="FTE" EmployeeNumber="5678" />
                     <Employee Name="Amy E. Alberts" Type="CSG" EmployeeNumber="99222" />
                     <Employee Name="Stefan Hesse" Type="Vendor" EmployeeNumber="-" />
                 </Employees>
             </x:XData>
         </XmlDataProvider>
         
         <CollectionViewSource  x:Key="cvs" Source="{Binding Source={StaticResource Employees}, XPath=/Employees/*}">
             <CollectionViewSource.SortDescriptions>
                <!--在这里插入排序描述-->
             </CollectionViewSource.SortDescriptions>
             <CollectionViewSource.GroupDescriptions>
                 <!--在这里插入分组描述-->
             </CollectionViewSource.GroupDescriptions>
         </CollectionViewSource>
         
         <DataTemplate  DataType="Employee">
             <TextBlock Text="{Binding XPath=@Name}" />
         </DataTemplate>
         
     </Window.Resources>

     <StackPanel>
         <ListBox ItemsSource="{Binding Source={StaticResource cvs}}" x:Name="lb"/>
     </StackPanel>

 

默认的数据集视图供参考：

集合数据	默认视图	注释
IEnumerable	CollectionView	无法对项进行分组。
IList	ListCollectionView	最快。
IBindingList	BindingListCollectionView

 

public partial class Window1 : Window
    {

        private void buttonPrevious_Click(object sender, RoutedEventArgs e)
        {
            ICollectionView view = GetFamilyView();
            view.MoveCurrentToPrevious();
        }

        private void buttonNext_Click(object sender, RoutedEventArgs e)
        {
            ICollectionView view = GetFamilyView();
            view.MoveCurrentToNext();
        }

        ICollectionView GetFamilyView()
        {
            People people = this.FindResource("Family") as People;
            return CollectionViewSource.GetDefaultView(people);
        }

    }

 

• 过滤筛选

同时为该排序按钮提供点击事件如下： 

 

private void buttonFilter_Click(object sender, RoutedEventArgs e)
        {
            ICollectionView view = GetFamilyView();
            view.Filter = delegate(object target)
                {
                    return ((Person)target).Age > 25;
                };
            //view.Filter = new Predicate<object>(delegate(object target)
            //    {
            //        return ((Person)target).Age > 25;
            //    });
        }

过滤比较简单，不在赘述。在这里只要理解Predicate<object>型别这个委托变量Filter就行了。视图里面的每一项满足条件的返回出来

• 分组

获取数据源视图，在分组描述里加上需要分组的属性分组描述，这里需要分组的是Age

private void buttonGroup_Click(object sender, RoutedEventArgs e)
        {
            ICollectionView view = GetFamilyView();
            view.GroupDescriptions.Add(new PropertyGroupDescription("Age"));
        }

接下来是开启GroupStyle，并设置GroupStyle的样式就可以了

注意：在GroupStyle中绑定的Name不是指Person中的Name，而是view.GroupDescriptions.Add(new PropertyGroupDescription("Age"));中指定的这个Age。 

   上文也说了，这是一种最简单的分组，在实际应用中，分组往往要复杂的多。比如以年龄分组来说，就不可能像上文中一样，以一岁做为一组。现在，我们来实现如下的分组要求： 

   0-30：年轻； 

   30-60：中年； 

   >60：老年； 

   所有的自定义分组器都需要实现接口IValueConverter，如下： 

class AgeToRangeConver: IValueConverter
    {

        #region IValueConverter 成员

        public object Convert(object value, Type targetType, object parameter, System.Globalization.CultureInfo culture)
        {
            int iValue = (int)value;
            if (0 < iValue && iValue <= 30)
            {
                return "年轻";
            }
            else if (30 < iValue && iValue <= 60)
            {
                return "中年";
            }
            else
            {
                return "老年";
            }
        }

        public object ConvertBack(object value, Type targetType, object parameter, System.Globalization.CultureInfo culture)
        {
            throw new NotImplementedException();
        }

        #endregion
    }

然后，点击事件修改为： 

private void buttonGroup_Click(object sender, RoutedEventArgs e)
        {
            ICollectionView view = GetFamilyView();
            view.GroupDescriptions.Add(new PropertyGroupDescription("Age", new AgeToRangeConver()));
        }

可以看到，分组已经按我们的要求实现了。

• 排序

基本实现排序

private void buttonSort_Click(object sender, RoutedEventArgs e)
        {
            ICollectionView view = GetFamilyView();
            view.SortDescriptions.Add(new SortDescription("Age", ListSortDirection.Ascending));
        }

有时候默认的比较器不能满足我们排序的需求，我们会用到自定义排序

class PersonAgeSort: IComparer
    {

        #region IComparer 成员

        public int Compare(object x, object y)
        {
            Person personx = x as Person;
            Person persony = y as Person;
            if (personx.Age > persony.Age)
            {
                return 1;
            }
            else if (personx.Age == persony.Age)
            {
                return 0;
            }
            else
            {
                return -1;
            }
            //return personx.Age.CompareTo(persony.Age);
        }

        #endregion
    }

     然后，按钮事件改为： 

        private void buttonSort_Click(object sender, RoutedEventArgs e)
        {
            ListCollectionView view = GetFamilyView() as ListCollectionView;
            view.CustomSort = new PersonAgeSort();                        
        }

注意按钮事件中，我们将GetFamilyView方法返回值转型为了ListCollectionView。因为他在WPF时用来包装IList接口并提供视图功能的类。在WPF中还有一些ICollectionView接口的实现，但有些不提供自定义排序，所以在使用起来要注意。尤