DataGridViewCheckBoxCell 类

定义

显示要在 DataGridView 控件中使用的复选框用户界面 (UI)。

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
继承
DataGridViewCheckBoxCell
实现

示例

下面的代码示例使用 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 属性设置为要用作模式的单元格。

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

当当前单元格为 时 DataGridViewCheckBoxCellDataGridView.IsCurrentCellInEditMode 属性始终 true为 。

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

继承者说明

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

构造函数

DataGridViewCheckBoxCell()

DataGridViewCheckBoxCell 类的新实例初始化为其默认状态。

DataGridViewCheckBoxCell(Boolean)

初始化 DataGridViewCheckBoxCell 类的一个新实例,并启用二元或三元状态。

属性

AccessibilityObject

获取分配给 DataGridViewCell.DataGridViewCellAccessibleObjectDataGridViewCell

(继承自 DataGridViewCell)
ColumnIndex

获取此单元格的列索引。

(继承自 DataGridViewCell)
ContentBounds

获取环绕单元格内容区域的边框。

(继承自 DataGridViewCell)
ContextMenuStrip

获取或设置与单元格关联的快捷菜单。

(继承自 DataGridViewCell)
DataGridView

获取与此元素关联的 DataGridView 控件。

(继承自 DataGridViewElement)
DefaultNewRowValue

获取新记录所在行中单元格的默认值。

(继承自 DataGridViewCell)
Displayed

获取一个值,该值指示当前该单元格是否显示在屏幕上。

(继承自 DataGridViewCell)
EditedFormattedValue

获取该单元格的当前格式化值,而不考虑该单元格是否处于编辑模式,也不论是否尚未提交此值。

(继承自 DataGridViewCell)
EditingCellFormattedValue

当单元格处于编辑模式下时获取或设置其承载的控件的格式化值。

EditingCellValueChanged

获取或设置一个标志,该标志指示已为此单元格更改值。

EditType

获取单元格的寄宿编辑控件的类型。

ErrorIconBounds

获取单元格的错误图标的界限。

(继承自 DataGridViewCell)
ErrorText

获取或设置描述与该单元格关联的错误条件的文本。

(继承自 DataGridViewCell)
FalseValue

获取或设置与 false 的单元格值对应的基础值。

FlatStyle

获取或设置复选框用户界面 (UI) 的平面样式外观。

FormattedValue

获取为显示进行格式化的单元格的值。

(继承自 DataGridViewCell)
FormattedValueType

获取单元格显示值的类型。

Frozen

获取指示单元格是否已被冻结的值。

(继承自 DataGridViewCell)
HasStyle

获取指示是否已设置 Style 属性的值。

(继承自 DataGridViewCell)
IndeterminateValue

获取或设置与不确定或 null 单元格值对应的基础值。

InheritedState

获取该单元格从它的行和列的状态继承后的当前状态。

(继承自 DataGridViewCell)
InheritedStyle

获取当前应用于单元格的样式。

(继承自 DataGridViewCell)
IsInEditMode

获取一个值,该值指示此单元格当前是否处于编辑状态。

(继承自 DataGridViewCell)
OwningColumn

获取包含此单元格的列。

(继承自 DataGridViewCell)
OwningRow

获取包含此单元格的行。

(继承自 DataGridViewCell)
PreferredSize

获取适合该单元格的矩形区域的大小(以像素为单位)。

(继承自 DataGridViewCell)
ReadOnly

获取或设置一个值,该值表示是否可以编辑该单元格的数据。

(继承自 DataGridViewCell)
Resizable

获取一个值,该值指示是否可以调整单元格的大小。

(继承自 DataGridViewCell)
RowIndex

获取单元格父行的索引。

(继承自 DataGridViewCell)
Selected

获取或设置一个值,该值指示是否已选定该单元格。

(继承自 DataGridViewCell)
Size

获取单元格的大小。

(继承自 DataGridViewCell)
State

获取元素的用户界面 (UI) 状态。

(继承自 DataGridViewElement)
Style

获取或设置单元格的样式。

(继承自 DataGridViewCell)
Tag

获取或设置包含有关单元格补充数据的对象。

(继承自 DataGridViewCell)
ThreeState

获取或设置一个值,该值指示是否已对承载的复选框控件启用三元模式。

ToolTipText

获取或设置与此单元格关联的 ToolTip 文本。

(继承自 DataGridViewCell)
TrueValue

获取或设置与 true 的单元格值对应的基础值。

Value

获取或设置与此单元格关联的值。

(继承自 DataGridViewCell)
ValueType

获取单元格中的值的数据类型。

Visible

获取一个值,该值指示单元格是否位于已隐藏的行或列中。

(继承自 DataGridViewCell)

方法

AdjustCellBorderStyle(DataGridViewAdvancedBorderStyle, DataGridViewAdvancedBorderStyle, Boolean, Boolean, Boolean, Boolean)

根据指定条件修改输入单元格的边框样式。

(继承自 DataGridViewCell)
BorderWidths(DataGridViewAdvancedBorderStyle)

返回一个 Rectangle,它表示所有单元格的边距宽度。

(继承自 DataGridViewCell)
ClickUnsharesRow(DataGridViewCellEventArgs)

指示在单击单元格时,是否对单元格所在的行取消共享。

(继承自 DataGridViewCell)
Clone()

创建此单元格的精确副本。

ContentClickUnsharesRow(DataGridViewCellEventArgs)

指示当单击单元格内容时是否会导致包含该单元格的行取消共享。

ContentDoubleClickUnsharesRow(DataGridViewCellEventArgs)

指示当双击单元格内容时是否会导致包含该单元格的行取消共享。

CreateAccessibilityInstance()

DataGridViewCheckBoxCell 创建一个新的可访问对象。

DetachEditingControl()

DataGridView 中删除单元格的编辑控件。

(继承自 DataGridViewCell)
Dispose()

释放由 DataGridViewCell 使用的所有资源。

(继承自 DataGridViewCell)
Dispose(Boolean)

释放由 DataGridViewCell 占用的非托管资源,还可以另外再释放托管资源。

(继承自 DataGridViewCell)
DoubleClickUnsharesRow(DataGridViewCellEventArgs)

指示在双击单元格时,是否对该单元格所在的行取消共享。

(继承自 DataGridViewCell)
EnterUnsharesRow(Int32, Boolean)

指示在焦点移到某单元格时,是否对相应父行取消共享。

(继承自 DataGridViewCell)
Equals(Object)

确定指定对象是否等于当前对象。

(继承自 Object)
GetClipboardContent(Int32, Boolean, Boolean, Boolean, Boolean, String)

检索要复制到 Clipboard 的单元格的已设置格式的值。

(继承自 DataGridViewCell)
GetContentBounds(Graphics, DataGridViewCellStyle, Int32)

返回围绕单元格内容区域的边框,该区域是使用指定的 Graphics 和单元格样式计算的。

GetContentBounds(Int32)

使用默认的 Graphics 和单元格当前应用的单元格样式,返回围绕单元格内容区域的边框。

(继承自 DataGridViewCell)
GetEditedFormattedValue(Int32, DataGridViewDataErrorContexts)

返回该单元格的当前格式化值,而不考虑该单元格是否处于编辑模式,也无论是否尚未提交此值。

(继承自 DataGridViewCell)
GetEditingCellFormattedValue(DataGridViewDataErrorContexts)

当单元格处于编辑模式时获取其格式化值。

GetErrorIconBounds(Graphics, DataGridViewCellStyle, Int32)

如果显示了单元格的错误图标,则返回环绕该图标的边框。

GetErrorText(Int32)

返回表示单元格错误的字符串。

(继承自 DataGridViewCell)
GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts)

获取单元格数据的格式化值。

GetHashCode()

作为默认哈希函数。

(继承自 Object)
GetInheritedContextMenuStrip(Int32)

获取当前单元格的继承快捷菜单。

(继承自 DataGridViewCell)
GetInheritedState(Int32)

返回一个值,该值指示此单元格从它的行和列的状态继承后的当前状态。

(继承自 DataGridViewCell)
GetInheritedStyle(DataGridViewCellStyle, Int32, Boolean)

获取应用于单元格的样式。

(继承自 DataGridViewCell)
GetPreferredSize(Graphics, DataGridViewCellStyle, Int32, Size)

计算单元格的首选大小(以像素为单位)。

GetSize(Int32)

获取单元格的大小。

(继承自 DataGridViewCell)
GetType()

获取当前实例的 Type

(继承自 Object)
GetValue(Int32)

获取单元格的值。

(继承自 DataGridViewCell)
InitializeEditingControl(Int32, Object, DataGridViewCellStyle)

初始化用于编辑单元格的控件。

(继承自 DataGridViewCell)
KeyDownUnsharesRow(KeyEventArgs, Int32)

指示当单元格有焦点时,按某个键是否会导致包含该单元格的行取消共享。

KeyEntersEditMode(KeyEventArgs)

确定是否应基于给定键启动编辑模式。

(继承自 DataGridViewCell)
KeyPressUnsharesRow(KeyPressEventArgs, Int32)

指示在焦点位于该行的单元格上并同时按任意键时,是否取消行的共享。

(继承自 DataGridViewCell)
KeyUpUnsharesRow(KeyEventArgs, Int32)

指示当单元格有焦点时,松开某个键是否会导致包含该单元格的行取消共享。

LeaveUnsharesRow(Int32, Boolean)

指示在焦点离开某行的单元格时,是否对该行取消共享。

(继承自 DataGridViewCell)
MemberwiseClone()

创建当前 Object 的浅表副本。

(继承自 Object)
MouseClickUnsharesRow(DataGridViewCellMouseEventArgs)

指示在鼠标指针位于某行的单元格上,同时用户单击鼠标按钮时,是否应对该行取消共享。

(继承自 DataGridViewCell)
MouseDoubleClickUnsharesRow(DataGridViewCellMouseEventArgs)

指示当用户双击行中的单元格时,是否将对该行取消共享。

(继承自 DataGridViewCell)
MouseDownUnsharesRow(DataGridViewCellMouseEventArgs)

指示当指针放置在单元格上时,按鼠标按钮是否会导致包含该单元格的行取消共享。

MouseEnterUnsharesRow(Int32)

指示当鼠标指针移到单元格上时是否会导致包含该单元格的行取消共享。

MouseLeaveUnsharesRow(Int32)

指示当鼠标指针离开单元格时是否会导致包含该单元格的行取消共享。

MouseMoveUnsharesRow(DataGridViewCellMouseEventArgs)

指示当鼠标指针移过行中某个单元格上时,该行是否取消共享状态。

(继承自 DataGridViewCell)
MouseUpUnsharesRow(DataGridViewCellMouseEventArgs)

指示当指针放置在单元格上时,松开鼠标按钮是否会导致包含该单元格的行取消共享。

OnClick(DataGridViewCellEventArgs)

在单击单元格时进行调用。

(继承自 DataGridViewCell)
OnContentClick(DataGridViewCellEventArgs)

在单击单元格的内容时进行调用。

OnContentDoubleClick(DataGridViewCellEventArgs)

在双击单元格的内容时进行调用。

OnDataGridViewChanged()

在单元格的 DataGridView 属性更改时调用。

(继承自 DataGridViewCell)
OnDoubleClick(DataGridViewCellEventArgs)

在双击单元格时进行调用。

(继承自 DataGridViewCell)
OnEnter(Int32, Boolean)

在焦点移动到单元格时进行调用。

(继承自 DataGridViewCell)
OnKeyDown(KeyEventArgs, Int32)

在焦点位于单元格上并同时按下字符键时进行调用。

OnKeyPress(KeyPressEventArgs, Int32)

在焦点位于单元格上并同时按任意键时进行调用。

(继承自 DataGridViewCell)
OnKeyUp(KeyEventArgs, Int32)

在焦点位于单元格上并同时释放字符键时进行调用。

OnLeave(Int32, Boolean)

当焦点从单元格上移开时调用。

OnMouseClick(DataGridViewCellMouseEventArgs)

在指针位于单元格上且用户同时单击鼠标按钮时进行调用。

(继承自 DataGridViewCell)
OnMouseDoubleClick(DataGridViewCellMouseEventArgs)

在指针位于单元格上,同时用户双击鼠标按钮时进行调用。

(继承自 DataGridViewCell)
OnMouseDown(DataGridViewCellMouseEventArgs)

当指针在单元格上并按住鼠标按钮时调用。

OnMouseEnter(Int32)

当鼠标指针移到单元格上时调用。

(继承自 DataGridViewCell)
OnMouseLeave(Int32)

当鼠标指针从单元格上移开时调用。

OnMouseMove(DataGridViewCellMouseEventArgs)

当鼠标指针在单元格内移动时调用。

OnMouseUp(DataGridViewCellMouseEventArgs)

当指针在单元格上时,在松开鼠标按钮时调用。

Paint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Object, Object, String, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle, DataGridViewPaintParts)

绘制当前的 DataGridViewCheckBoxCell

PaintBorder(Graphics, Rectangle, Rectangle, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle)

绘制当前 DataGridViewCell 的边框。

(继承自 DataGridViewCell)
PaintErrorIcon(Graphics, Rectangle, Rectangle, String)

绘制当前 DataGridViewCell 的错误图标。

(继承自 DataGridViewCell)
ParseFormattedValue(Object, DataGridViewCellStyle, TypeConverter, TypeConverter)

将为便于显示而进行了格式设置的值转换为实际的单元格值。

PositionEditingControl(Boolean, Boolean, Rectangle, Rectangle, DataGridViewCellStyle, Boolean, Boolean, Boolean, Boolean)

设置由 DataGridView 控件中的单元格承载的编辑控件的位置和大小。

(继承自 DataGridViewCell)
PositionEditingPanel(Rectangle, Rectangle, DataGridViewCellStyle, Boolean, Boolean, Boolean, Boolean)

设置单元格承载的编辑面板的位置和大小,并返回编辑面板内编辑控件的正常界限。

(继承自 DataGridViewCell)
PrepareEditingCellForEdit(Boolean)

此方法对此类型毫无意义。

RaiseCellClick(DataGridViewCellEventArgs)

引发 CellClick 事件。

(继承自 DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)

引发 CellContentClick 事件。

(继承自 DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)

引发 CellContentDoubleClick 事件。

(继承自 DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)

引发 CellValueChanged 事件。

(继承自 DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)

引发 DataError 事件。

(继承自 DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)

引发 MouseWheel 事件。

(继承自 DataGridViewElement)
SetValue(Int32, Object)

设置单元格的值。

(继承自 DataGridViewCell)
ToString()

返回单元格的字符串表示形式。

适用于

另请参阅