DataGridViewCheckBoxColumn クラス

定義

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

[System.Drawing.ToolboxBitmap(typeof(System.Windows.Forms.DataGridViewCheckBoxColumn), "DataGridViewCheckBoxColumn.bmp")]
public 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.bmp")>]
type DataGridViewCheckBoxColumn = class
    inherit 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には、交差するすべてのDataGridViewCheckBoxCellに関連付けられたDataGridViewRowがあります。 各セルには、 CheckBox コントロールに似たユーザー インターフェイス (UI) が用意されています。

この列の種類の既定の並べ替えモードは NotSortable。

通常、チェック ボックスのセル値は、他のデータと同様にストレージ用か、一括操作を実行するためのものです。 ユーザーがチェック ボックス セルをクリックしたときにすぐに応答する場合は、 DataGridView.CellContentClick イベントを処理できますが、このイベントはセル値が更新される前に発生します。 クリック時に新しい値が必要な場合は、現在の値に基づいて予想される値を計算するオプションがあります。 もう 1 つの方法は、変更を直ちにコミットし、それに応答するために DataGridView.CellValueChanged イベントを処理することです。 セルがクリックされたときに変更をコミットするには、 DataGridView.CurrentCellDirtyStateChanged イベントを処理する必要があります。 ハンドラーで、現在のセルがチェック ボックス セルの場合は、 DataGridView.CommitEdit メソッドを呼び出し、 Commit 値を渡します。

注意 (継承者)

DataGridViewCheckBoxColumnから派生し、派生クラスに新しいプロパティを追加する場合は、Clone() メソッドをオーバーライドして、複製操作中に新しいプロパティをコピーしてください。 基底クラスのプロパティが新しいセルにコピーされるように、基底クラスの Clone() メソッドも呼び出す必要があります。

こちらもご覧ください

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