DataGridViewCheckBoxCell 类

定义

public ref class DataGridViewCheckBoxCell : System::Windows::Forms::DataGridViewCell, System::Windows::Forms::IDataGridViewEditingCell

public class DataGridViewCheckBoxCell : System.Windows.Forms.DataGridViewCell, System.Windows.Forms.IDataGridViewEditingCell

type DataGridViewCheckBoxCell = class
    inherit DataGridViewCell
    interface IDataGridViewEditingCell

Public Class DataGridViewCheckBoxCell
Inherits DataGridViewCell
Implements IDataGridViewEditingCell

继承

Object

DataGridViewElement

DataGridViewCell

DataGridViewCheckBoxCell

实现

IDataGridViewEditingCell

示例

下面的代码示例使用 DataGridViewCheckBoxColumn 来跟踪哪些员工在办公室工作。 该列由 对象组成 DataGridViewCheckBoxCell 。 此示例是类概述主题中提供的更大示例的 DataGridViewComboBoxColumn 一部分。

private:
    void AddOutOfOfficeColumn()
    {
        DataGridViewCheckBoxColumn^ column = gcnew DataGridViewCheckBoxColumn();
        {
            column->HeaderText = ColumnName::OutOfOffice.ToString();
            column->Name = ColumnName::OutOfOffice.ToString();
            column->AutoSizeMode = 
                DataGridViewAutoSizeColumnMode::DisplayedCells;
            column->FlatStyle = FlatStyle::Standard;
            column->ThreeState = true;
            column->CellTemplate = gcnew DataGridViewCheckBoxCell();
            column->CellTemplate->Style->BackColor = Color::Beige;
        }

        DataGridView1->Columns->Insert(0, column);
    }

private void AddOutOfOfficeColumn()
{
    DataGridViewCheckBoxColumn column = new DataGridViewCheckBoxColumn();
    {
        column.HeaderText = ColumnName.OutOfOffice.ToString();
        column.Name = ColumnName.OutOfOffice.ToString();
        column.AutoSizeMode = 
            DataGridViewAutoSizeColumnMode.DisplayedCells;
        column.FlatStyle = FlatStyle.Standard;
        column.ThreeState = true;
        column.CellTemplate = new DataGridViewCheckBoxCell();
        column.CellTemplate.Style.BackColor = Color.Beige;
    }

    DataGridView1.Columns.Insert(0, column);
}

Private Sub AddOutOfOfficeColumn()
    Dim column As New DataGridViewCheckBoxColumn()
    With column
        .HeaderText = ColumnName.OutOfOffice.ToString()
        .Name = ColumnName.OutOfOffice.ToString()
        .AutoSizeMode = DataGridViewAutoSizeColumnMode.DisplayedCells
        .FlatStyle = FlatStyle.Standard
        .CellTemplate = New DataGridViewCheckBoxCell()
        .CellTemplate.Style.BackColor = Color.Beige
    End With

    DataGridView1.Columns.Insert(0, column)
End Sub

注解

类DataGridViewCheckBoxCell是一种专用类型的 ，DataGridViewCell用于显示通过检查框 UI 呈现的二进制或三元信息。 在默认二进制模式下，单元格可以保存 或 false的值true。 在三元模式下，单元格采用值之 CheckState 一。 属性 ThreeState 确定二元模式还是三元模式有效。

DataGridViewCheckBoxColumn是专用于保存此类型的单元格的列类型。 默认情况下， DataGridViewCheckBoxColumn.CellTemplate 初始化为新的 DataGridViewCheckBoxCell。 若要在现有 DataGridViewCheckBoxCell之后对列中的单元格进行图案化，请将列的 CellTemplate 属性设置为要用作模式的单元格。

列的单元格相关属性是模板单元格中类似名称的属性的包装器。 更改模板单元格的属性值将仅影响基于更改后添加的模板的单元格。 但是，更改列的单元格相关属性值将更新模板单元格和列中的所有其他单元格，并在必要时刷新列显示。

当当前单元格为 时 DataGridViewCheckBoxCell， DataGridView.IsCurrentCellInEditMode 属性始终 true为 。

通常，复选框单元格值用于存储（与任何其他数据一样）或用于执行批量操作。 如果希望在用户单击复选框单元格时立即响应，则可以处理 DataGridView.CellClick 事件，但此事件会在单元格值更新之前发生。 如果需要在单击时显示新值，一种选择是根据当前值计算预期值。 另一种方法是立即提交更改，并处理 DataGridView.CellValueChanged 事件以响应更改。 若要在单击单元格时提交更改，必须处理 DataGridView.CurrentCellDirtyStateChanged 事件。 在处理程序中，如果当前单元格是复选框单元格，请调用 DataGridView.CommitEdit 方法并传入 Commit 值。

继承者说明

从 DataGridViewCheckBoxCell 派生类并将新属性添加到派生类时，请务必重写 Clone() 方法，以在克隆操作期间复制新属性。 还应调用基类的 Clone() 方法，以便将基类的属性复制到新单元格。

另请参阅

• DataGridView
• DataGridViewCell
• DataGridViewCheckBoxColumn
• CellTemplate