DataGridCheckBoxColumn 类

定义

命名空间:

System.Windows.Controls

程序集:

PresentationFramework.dll

表示一个 DataGrid 列，该列在其单元格中承载 CheckBox 控件。

public ref class DataGridCheckBoxColumn : System::Windows::Controls::DataGridBoundColumn

public class DataGridCheckBoxColumn : System.Windows.Controls.DataGridBoundColumn

type DataGridCheckBoxColumn = class
    inherit DataGridBoundColumn

Public Class DataGridCheckBoxColumn
Inherits DataGridBoundColumn

继承

Object

DispatcherObject

DependencyObject

DataGridColumn

DataGridBoundColumn

DataGridCheckBoxColumn

示例

以下示例演示如何添加 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)

方法

CancelCellEdit(FrameworkElement, Object)	导致正在编辑的单元格还原为原始未编辑的值。 (继承自 DataGridColumn)
CheckAccess()	确定调用线程是否可以访问此 DispatcherObject。 (继承自 DispatcherObject)
ClearValue(DependencyProperty)	清除属性的本地值。 要清除的属性由 DependencyProperty 标识符指定。 (继承自 DependencyObject)
ClearValue(DependencyPropertyKey)	清除只读属性的本地值。 要清除的属性由 DependencyPropertyKey 指定。 (继承自 DependencyObject)
CoerceValue(DependencyProperty)	对指定依赖属性的值进行强制。 通过对调用方 DependencyObject 上存在的依赖属性的属性元数据中所指定的任何 CoerceValueCallback 函数进行调用来完成此操作。 (继承自 DependencyObject)
CommitCellEdit(FrameworkElement)	在退出单元格编辑模式之前执行任何必需的验证。 (继承自 DataGridColumn)
Equals(Object)	确定提供的 DependencyObject 是否等效于当前 DependencyObject。 (继承自 DependencyObject)
GenerateEditingElement(DataGridCell, Object)	获取一个 CheckBox 控件，该控件绑定到列的 Binding 属性值。
GenerateElement(DataGridCell, Object)	获取一个只读 CheckBox 控件，该控件绑定到列的 Binding 属性值。
GetCellContent(DataGridRow)	对于此列与指定行相交处的单元格，检索 Content 属性值。 (继承自 DataGridColumn)
GetCellContent(Object)	对于位于此列与表示指定数据项的行相交位置的单元格，获取 Content 属性值。 (继承自 DataGridColumn)
GetHashCode()	获取此 DependencyObject 的哈希代码。 (继承自 DependencyObject)
GetLocalValueEnumerator()	创建一个专用的枚举数，用于确定哪些依赖项属性在此 DependencyObject 上具有以本地方式设置的值。 (继承自 DependencyObject)
GetType()	获取当前实例的 Type。 (继承自 Object)
GetValue(DependencyProperty)	对 DependencyObject 的此实例返回依赖属性的当前有效值。 (继承自 DependencyObject)
InvalidateProperty(DependencyProperty)	重新评估指定依赖属性的有效值。 (继承自 DependencyObject)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
NotifyPropertyChanged(String)	通知包含此列的 DataGrid 有个列属性被更改了。 (继承自 DataGridColumn)
OnBindingChanged(BindingBase, BindingBase)	注意，DataGrid 属性的值更改时的 Binding。 (继承自 DataGridBoundColumn)
OnCoerceIsReadOnly(Boolean)	基于包含此列的数据网格的属性规则，确定 IsReadOnly 属性的值。 (继承自 DataGridBoundColumn)
OnCopyingCellClipboardContent(Object)	引发 CopyingCellClipboardContent 事件。 (继承自 DataGridColumn)
OnPastingCellClipboardContent(Object, Object)	引发 PastingCellClipboardContent 事件。 (继承自 DataGridColumn)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	每当更新此 DependencyObject 的任何依赖属性的有效值时调用。 更改的特定依赖属性将在事件数据中报告。 (继承自 DependencyObject)
PrepareCellForEdit(FrameworkElement, RoutedEventArgs)	当列中的单元格进入编辑模式时调用。
ReadLocalValue(DependencyProperty)	如果存在，则返回依赖属性的本地值。 (继承自 DependencyObject)
RefreshCellContent(FrameworkElement, String)	刷新列中单元格的内容，以响应列属性值更改。
SetCurrentValue(DependencyProperty, Object)	设置依赖属性的值而不更改其值源。 (继承自 DependencyObject)
SetValue(DependencyProperty, Object)	设置依赖属性的本地值，该值由其依赖属性标识符指定。 (继承自 DependencyObject)
SetValue(DependencyPropertyKey, Object)	设置一个只读依赖属性的本地值，该值由依赖属性的 DependencyPropertyKey 标识符指定。 (继承自 DependencyObject)
ShouldSerializeProperty(DependencyProperty)	返回一个值，该值指示序列化进程是否应序列化所提供的依赖属性的值。 (继承自 DependencyObject)
ToString()	返回表示当前对象的字符串。 (继承自 Object)
VerifyAccess()	强制调用线程具有此 DispatcherObject 的访问权限。 (继承自 DispatcherObject)

事件

CopyingCellClipboardContent	在单元格剪贴板内容准备好之后发生。 (继承自 DataGridColumn)
PastingCellClipboardContent	在剪贴板内容传输到单元格之前发生。 (继承自 DataGridColumn)

另请参阅

• CheckBox