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 |
取得或設定與這個儲存格相關聯的工具提示文字。 (繼承來源 DataGridViewCell) |
| TrueValue |
取得或設定對應到 |
| Value |
取得或設定與這個儲存格相關聯的值。 (繼承來源 DataGridViewCell) |
| ValueType |
取得儲存格中的值之資料型別。 |
| Visible |
取得指出儲存格是在已隱藏資料列或是資料行中的值。 (繼承來源 DataGridViewCell) |
方法
適用於
另請參閱
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應