DataGridViewCheckBoxColumn 类

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

承载一个 DataGridViewCheckBoxCell 对象集合。

public ref class DataGridViewCheckBoxColumn : System::Windows::Forms::DataGridViewColumn

[System.Drawing.ToolboxBitmap(typeof(System.Windows.Forms.DataGridViewCheckBoxColumn), "DataGridViewCheckBoxColumn")]
public class DataGridViewCheckBoxColumn : System.Windows.Forms.DataGridViewColumn

[<System.Drawing.ToolboxBitmap(typeof(System.Windows.Forms.DataGridViewCheckBoxColumn), "DataGridViewCheckBoxColumn")>]
type DataGridViewCheckBoxColumn = class
    inherit DataGridViewColumn

Public Class DataGridViewCheckBoxColumn
Inherits DataGridViewColumn

继承

Object

DataGridViewElement

DataGridViewBand

DataGridViewColumn

DataGridViewCheckBoxColumn

属性

ToolboxBitmapAttribute

示例

下面的代码示例演示如何使用 来 DataGridViewCheckBoxColumn 标记哪些员工外出。 此示例是类概述主题中提供的更大示例的 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

注解

类 DataGridViewCheckBoxColumn 是类的一种专用类型， DataGridViewColumn 用于以逻辑方式托管指示二进制状态的单元格。 在DataGridViewCheckBoxColumn与之相交的每个中都有DataGridViewRow关联的 DataGridViewCheckBoxCell 。 每个单元格都提供一个用户界面 (UI) ，类似于控件 CheckBox 。

此列类型的默认排序模式为 NotSortable。

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

继承者说明

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

构造函数

DataGridViewCheckBoxColumn()	将 DataGridViewCheckBoxColumn 类的新实例初始化为默认状态。
DataGridViewCheckBoxColumn(Boolean)	初始化 DataGridViewCheckBoxColumn 的新实例并将其配置为显示具有两种或三种状态的复选框。

属性

AutoSizeMode	获取或设置模式，通过此模式列可以自动调整其宽度。 (继承自 DataGridViewColumn)
CellTemplate	获取或设置用于创建新单元格的模板。
CellType	获取单元格模板的运行时类型。 (继承自 DataGridViewColumn)
ContextMenuStrip	获取或设置列的快捷菜单。 (继承自 DataGridViewColumn)
DataGridView	获取与此元素关联的 DataGridView 控件。 (继承自 DataGridViewElement)
DataPropertyName	获取或设置数据源属性的名称或与 DataGridViewColumn 绑定的数据库列的名称。 (继承自 DataGridViewColumn)
DefaultCellStyle	获取或设置列的默认单元格样式。
DefaultHeaderCellType	获取或设置默认标题单元格的运行时类型。 (继承自 DataGridViewBand)
Displayed	获取一个值，该值指示带区当前是否显示在屏幕上。 (继承自 DataGridViewBand)
DisplayIndex	相对于当前所显示各列，获取或设置列的显示顺序。 (继承自 DataGridViewColumn)
DividerWidth	获取或设置列分隔符的宽度（以像素为单位）。 (继承自 DataGridViewColumn)
FalseValue	获取或设置对应于 false 单元格值（显示为取消选中的复选框）的基础值。
FillWeight	获取或设置一个值，表示当该列处于填充模式时，相对于控件中处于填充模式的其他列的宽度。 (继承自 DataGridViewColumn)
FlatStyle	获取或设置复选框单元格的平面样式外观。
Frozen	获取或设置一个值，指示当用户水平滚动 DataGridView 控件时，列是否移动。 (继承自 DataGridViewColumn)
HasDefaultCellStyle	获取指示是否已设置 DefaultCellStyle 属性的值。 (继承自 DataGridViewBand)
HeaderCell	获取或设置表示列标题的 DataGridViewColumnHeaderCell。 (继承自 DataGridViewColumn)
HeaderCellCore	获取或设置 DataGridViewBand 的标题单元格。 (继承自 DataGridViewBand)
HeaderText	获取或设置列标题单元格的标题文本。 (继承自 DataGridViewColumn)
IndeterminateValue	获取或设置对应于不确定或 null 单元格值（显示为禁用复选框）的基础值。
Index	获取带区在 DataGridView 控件中的相对位置。 (继承自 DataGridViewBand)
InheritedAutoSizeMode	获取对该列有效的缩放模式。 (继承自 DataGridViewColumn)
InheritedStyle	获取当前应用于该列的单元格样式。 (继承自 DataGridViewColumn)
IsDataBound	获取一个值，指示该列是否绑定到某个数据源。 (继承自 DataGridViewColumn)
IsRow	获取一个值，该值指示带区是否表示一个行。 (继承自 DataGridViewBand)
MinimumWidth	获取或设置列的最小宽度（以像素为单位）。 (继承自 DataGridViewColumn)
Name	获取或设置该列的名称。 (继承自 DataGridViewColumn)
ReadOnly	获取或设置一个值，指示用户是否可以编辑列的单元格。 (继承自 DataGridViewColumn)
Resizable	获取或设置一个值，指示该列的大小是否可调。 (继承自 DataGridViewColumn)
Selected	获取或设置一个值，该值指示带区是否为被选定。 (继承自 DataGridViewBand)
Site	获取或设置列的站点。 (继承自 DataGridViewColumn)
SortMode	获取或设置列的排序模式。 (继承自 DataGridViewColumn)
State	获取元素的用户界面 (UI) 状态。 (继承自 DataGridViewElement)
Tag	获取或设置包含与带区关联的数据的对象。 (继承自 DataGridViewBand)
ThreeState	获取或设置一个值，该值指示此寄宿的复选框单元格是否允许三种复选状态而不是两种。
ToolTipText	获取或设置用于工具提示的文本。 (继承自 DataGridViewColumn)
TrueValue	获取或设置对应于 true 单元格值（显示为取消选中的复选框）的基础值。
ValueType	获取或设置列单元格中值的数据类型。 (继承自 DataGridViewColumn)
Visible	获取或设置一个值，该值指示该列是否可见。 (继承自 DataGridViewColumn)
Width	获取或设置该列的当前宽度。 (继承自 DataGridViewColumn)

方法

Clone()	创建此区段的一个完全相同的副本。 (继承自 DataGridViewColumn)
Dispose()	释放由 DataGridViewBand 使用的所有资源。 (继承自 DataGridViewBand)
Dispose(Boolean)	释放由 DataGridViewBand 占用的非托管资源，还可以另外再释放托管资源。 (继承自 DataGridViewColumn)
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetPreferredWidth(DataGridViewAutoSizeColumnMode, Boolean)	根据指定条件计算列的理想宽度。 (继承自 DataGridViewColumn)
GetType()	获取当前实例的 Type。 (继承自 Object)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
OnDataGridViewChanged()	当带区与其他 DataGridView 关联时调用。 (继承自 DataGridViewBand)
RaiseCellClick(DataGridViewCellEventArgs)	引发 CellClick 事件。 (继承自 DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)	引发 CellContentClick 事件。 (继承自 DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)	引发 CellContentDoubleClick 事件。 (继承自 DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)	引发 CellValueChanged 事件。 (继承自 DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)	引发 DataError 事件。 (继承自 DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)	引发 MouseWheel 事件。 (继承自 DataGridViewElement)
ToString()	获取一个描述该列的字符串。

事件

Disposed

释放 DataGridViewColumn 时发生。 (继承自 DataGridViewColumn)

另请参阅

• DataGridView
• DataGridViewColumn
• DataGridViewRow
• DataGridViewCheckBoxCell
• CheckBox
• SortMode
• CellClick
• CellValueChanged
• CurrentCellDirtyStateChanged
• CommitEdit(DataGridViewDataErrorContexts)