DataGridCheckBoxColumn 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
public ref class DataGridCheckBoxColumn : System::Windows::Controls::DataGridBoundColumnpublic class DataGridCheckBoxColumn : System.Windows.Controls.DataGridBoundColumntype DataGridCheckBoxColumn = class
inherit DataGridBoundColumnPublic Class DataGridCheckBoxColumn
Inherits DataGridBoundColumn- 继承
示例
以下示例演示如何添加 DataGridCheckBoxColumn。 此示例使用数据库作为源，并显示一列布尔数据。
<DataGrid Name="DG1" AutoGenerateColumns="False" ItemsSource="{Binding}">
<DataGrid.Columns>
<DataGridCheckBoxColumn Header="Online Order?" IsThreeState="True" Binding="{Binding OnlineOrderFlag}" />
</DataGrid.Columns>
</DataGrid>
注解
使用 DataGridCheckBoxColumn 将布尔数据的 CheckBox列显示为 。 下图显示了 的示例 DataGridCheckBoxColumn。
若要填充列，请使用 Binding 属性将该列绑定到数据。 属性 Binding 应用于在 CheckBox 列中创建的元素。 DataContext每个单元格中 元素的 是单元格所属行的数据项。 因此，若要设置绑定，只需设置 Binding.Path。 （可选）如果数据源和目标是不同的类型，则可以指定 Binding.Converter 。 有关数据绑定的详细信息，请参阅 数据绑定 (WPF) 。
可以通过设置属性（如 、、 HeaderIsThreeState和 IsReadOnly）Width来自定义 DataGridCheckBoxColumn 。
如果要显示其他类型的数据， DataGrid 请提供以下列类型：
| 列类型 | 数据显示 |
|---|---|
| DataGridHyperlinkColumn | 用于显示 URI 数据。 |
| DataGridComboBoxColumn | 用于显示枚举数据。 |
| DataGridTextColumn | 用于显示文本。 |
如果要在 中使用 DataGrid其他控件，可以使用 创建自己的列类型 DataGridTemplateColumn。
构造函数
| DataGridCheckBoxColumn() |
初始化 DataGridCheckBoxColumn 类的新实例。 |
字段
| IsThreeStateProperty |
标识 IsThreeState 依赖项属性。 |
属性
| ActualWidth |
获取列的当前宽度，以与设备无关的单位 (每单位) 1/96 英寸。 (继承自 DataGridColumn) |
| Binding |
获取或设置将列与数据源中的属性关联的绑定。 (继承自 DataGridBoundColumn) |
| CanUserReorder |
获取或设置一个值，该值指示用户能否通过拖放列标题来更改列的显示位置。 (继承自 DataGridColumn) |
| CanUserResize |
获取或设置一个值，该值指示用户是否可使用鼠标调整列宽。 (继承自 DataGridColumn) |
| CanUserSort |
获取或设置一个值，该值指示用户能否通过单击列标题对列进行排序。 (继承自 DataGridColumn) |
| CellStyle |
获取或设置用于呈现列中单元格的样式。 (继承自 DataGridColumn) |
| ClipboardContentBinding |
获取或设置要在获取或设置剪贴板的单元格内容时使用的绑定对象。 (继承自 DataGridBoundColumn) |
| DataGridOwner |
获取包含此列的 DataGrid 控件。 (继承自 DataGridColumn) |
| DefaultEditingElementStyle |
获取 EditingElementStyle 属性的默认值。 |
| DefaultElementStyle |
获取 ElementStyle 属性的默认值。 |
| DependencyObjectType |
DependencyObjectType获取包装此实例的 CLR 类型的 。 (继承自 DependencyObject) |
| Dispatcher |
获取与此 Dispatcher 关联的 DispatcherObject。 (继承自 DispatcherObject) |
| DisplayIndex |
获取或设置该列相对于 DataGrid 中其他列的显示位置。 (继承自 DataGridColumn) |
| DragIndicatorStyle |
获取或设置要在拖动操作过程中应用于列标题的样式对象。 (继承自 DataGridColumn) |
| EditingElementStyle |
获取或设置在呈现列为处于编辑模式的单元格显示的元素时使用的样式。 (继承自 DataGridBoundColumn) |
| ElementStyle |
获取或设置在呈现列为未处于编辑模式的单元格显示的元素时使用的样式。 (继承自 DataGridBoundColumn) |
| Header |
获取或设置列标题的内容。 (继承自 DataGridColumn) |
| HeaderStringFormat |
获取或设置要应用于列标题的内容的格式模式。 (继承自 DataGridColumn) |
| HeaderStyle |
获取或设置呈现列标题时使用的样式。 (继承自 DataGridColumn) |
| HeaderTemplate |
获取或设置定义列标题的可视化表示形式的模板。 (继承自 DataGridColumn) |
| HeaderTemplateSelector |
获取或设置选择要用于列标题的模板的对象。 (继承自 DataGridColumn) |
| IsAutoGenerated |
获取一个值，该值指示是否自动生成列。 (继承自 DataGridColumn) |
| IsFrozen |
获取一个值，该值指示是否阻止列水平滚动。 (继承自 DataGridColumn) |
| IsReadOnly |
获取或设置一个值，该值指示能否编辑列中的单元格。 (继承自 DataGridColumn) |
| IsSealed |
获取一个值，该值指示此实例当前是否为密封的（只读）。 (继承自 DependencyObject) |
| IsThreeState |
获取或设置一个值，该值指示所承载的 CheckBox 控件是支持三种状态还是两种状态。 |
| MaxWidth |
获取或设置列的最大宽度约束。 (继承自 DataGridColumn) |
| MinWidth |
获取或设置列的最小宽度约束。 (继承自 DataGridColumn) |
| SortDirection |
获取或设置列的排序方向(升序或降序)。 (继承自 DataGridColumn) |
| SortMemberPath |
获取或设置属性名称或用句点分隔的属性名称层次结构，它指示作为排序依据的成员。 (继承自 DataGridColumn) |
| Visibility |
获取或设置列的可见性。 (继承自 DataGridColumn) |
| Width |
获取或设置列的宽度或自动调整大小模式。 (继承自 DataGridColumn) |
方法
事件
| CopyingCellClipboardContent |
在单元格剪贴板内容准备好之后发生。 (继承自 DataGridColumn) |
| PastingCellClipboardContent |
在剪贴板内容传输到单元格之前发生。 (继承自 DataGridColumn) |
