DataGridCheckBoxColumn Class

Use DataGridCheckBoxColumn to display columns of Boolean data as a CheckBox. The following illustration shows an example of DataGridCheckBoxColumn.

To populate the column, bind the column to the data by using the Binding property. The Binding property is applied to the CheckBox element created in the column. The DataContext for the element in each cell is the data item for the row the cell is in. Therefore, to set up the binding you only have to set the Binding.Path. Optionally, you can specify a Binding.Converter if your data source and target are different types. For more information about data binding, see Data Binding (WPF).

You can customize the DataGridCheckBoxColumn by setting properties, such as Width, Header, IsThreeState, and IsReadOnly.

If you want to display other types of data, DataGrid provides the following column types:

If you want to use other controls in your DataGrid, you can create your own column types by using DataGridTemplateColumn.

The following example shows how to add a DataGridCheckBoxColumn. This example uses a database as the source and displays a column of Boolean data.

<DataGrid Name="DG1" AutoGenerateColumns="False" ItemsSource="{Binding}">
    <DataGrid.Columns>
        <DataGridCheckBoxColumn Header="Online Order?" IsThreeState="True" Binding="{Binding OnlineOrderFlag}" />
    </DataGrid.Columns>
</DataGrid>

.NET Framework

.NET Framework Client Profile

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

Other Resources