DataGridViewCheckBoxCell 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
显示要在 DataGridView 控件中使用的复选框用户界面 (UI)。
public ref class DataGridViewCheckBoxCell : System::Windows::Forms::DataGridViewCell, System::Windows::Forms::IDataGridViewEditingCellpublic class DataGridViewCheckBoxCell : System.Windows.Forms.DataGridViewCell, System.Windows.Forms.IDataGridViewEditingCelltype DataGridViewCheckBoxCell = class
inherit DataGridViewCell
interface IDataGridViewEditingCellPublic Class DataGridViewCheckBoxCell
Inherits DataGridViewCell
Implements 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() 方法，以便将基类的属性复制到新单元格。
构造函数
| DataGridViewCheckBoxCell() |
将 DataGridViewCheckBoxCell 类的新实例初始化为其默认状态。 |
| DataGridViewCheckBoxCell(Boolean) |
初始化 DataGridViewCheckBoxCell 类的一个新实例，并启用二元或三元状态。 |
属性
| AccessibilityObject |
获取分配给 DataGridViewCell.DataGridViewCellAccessibleObject 的 DataGridViewCell。 (继承自 DataGridViewCell) |
| ColumnIndex |
获取此单元格的列索引。 (继承自 DataGridViewCell) |
| ContentBounds |
获取环绕单元格内容区域的边框。 (继承自 DataGridViewCell) |
| ContextMenuStrip |
获取或设置与单元格关联的快捷菜单。 (继承自 DataGridViewCell) |
| DataGridView |
获取与此元素关联的 DataGridView 控件。 (继承自 DataGridViewElement) |
| DefaultNewRowValue |
获取新记录所在行中单元格的默认值。 (继承自 DataGridViewCell) |
| Displayed |
获取一个值，该值指示当前该单元格是否显示在屏幕上。 (继承自 DataGridViewCell) |
| EditedFormattedValue |
获取该单元格的当前格式化值，而不考虑该单元格是否处于编辑模式，也不论是否尚未提交此值。 (继承自 DataGridViewCell) |
| EditingCellFormattedValue |
当单元格处于编辑模式下时获取或设置其承载的控件的格式化值。 |
| EditingCellValueChanged |
获取或设置一个标志，该标志指示已为此单元格更改值。 |
| EditType |
获取单元格的寄宿编辑控件的类型。 |
| ErrorIconBounds |
获取单元格的错误图标的界限。 (继承自 DataGridViewCell) |
| ErrorText |
获取或设置描述与该单元格关联的错误条件的文本。 (继承自 DataGridViewCell) |
| FalseValue |
获取或设置与 |
| FlatStyle |
获取或设置复选框用户界面 (UI) 的平面样式外观。 |
| FormattedValue |
获取为显示进行格式化的单元格的值。 (继承自 DataGridViewCell) |
| FormattedValueType |
获取单元格显示值的类型。 |
| Frozen |
获取指示单元格是否已被冻结的值。 (继承自 DataGridViewCell) |
| HasStyle |
获取指示是否已设置 Style 属性的值。 (继承自 DataGridViewCell) |
| IndeterminateValue |
获取或设置与不确定或 |
| 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 |
获取或设置与 |
| Value |
获取或设置与此单元格关联的值。 (继承自 DataGridViewCell) |
| ValueType |
获取单元格中的值的数据类型。 |
| Visible |
获取一个值，该值指示单元格是否位于已隐藏的行或列中。 (继承自 DataGridViewCell) |
