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 。 每個儲存格都會提供與控制項類似的 CheckBox 使用者介面 (UI) 。

此資料行類型的預設排序模式為 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	取得或設定值，指出群組列是否位於已選取的使用者介面 (UI) 狀態下。 (繼承來源 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 所使用的 Unmanaged 資源，並選擇性地釋放 Managed 資源。 (繼承來源 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

發生於處置 (Dispose) DataGridViewColumn 時。 (繼承來源 DataGridViewColumn)

另請參閱

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