DataGridViewCheckBoxColumn クラス (System.Windows.Forms)

すべて縮小

言語フィルタ

このページは次のバージョンについて記述しています。

Microsoft Visual Studio 2005/.NET Framework 2.0

その他のバージョンについては、以下の情報を参照してください。

.NET Framework クラスライブラリ

DataGridViewCheckBoxColumn クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

DataGridViewCheckBoxCell オブジェクトのコレクションをホストします。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)

構文

Visual Basic (宣言)

Public Class DataGridViewCheckBoxColumn
    Inherits DataGridViewColumn

Visual Basic (使用法)

Dim instance As DataGridViewCheckBoxColumn

public class DataGridViewCheckBoxColumn : DataGridViewColumn

C++

public ref class DataGridViewCheckBoxColumn : public DataGridViewColumn

public class DataGridViewCheckBoxColumn extends DataGridViewColumn

JScript

public class DataGridViewCheckBoxColumn extends DataGridViewColumn

解説

DataGridViewCheckBoxColumn クラスは、DataGridViewColumn クラスの特殊な型で、2 進数の状態を示すセルを論理的にホストするために使用されます。DataGridViewCheckBoxColumn には、それと交差するすべての DataGridViewRow 内に、関連付けられた DataGridViewCheckBoxCell があります。各セルには、CheckBox コントロールに似たユーザーインターフェイス (UI) があります。

この列型の既定の並べ替えモードは、NotSortable です。

通常、チェックボックスセルの値は、他のデータと同様に情報を格納したり、一括操作を実行したりする目的で使用されます。ユーザーがチェックボックスセルをクリックしたときに直ちに応答する場合は、DataGridView.CellContentClick イベントを処理しますが、このイベントはセル値が更新される前に発生します。クリック時に新しい値が必要な場合は、現在の値を基に期待される値を計算するという方法が考えられます。また別の方法として、変更を直ちにコミットし、DataGridView.CellValueChanged イベントを処理してその変更に応答することも考えられます。セルがクリックされたときに変更をコミットするには、DataGridView.CurrentCellDirtyStateChanged イベントを処理する必要があります。現在のセルがチェックボックスセルである場合、ハンドラで DataGridView.CommitEdit メソッドを呼び出し、Commit の値を渡します。

継承時の注意 DataGridViewCheckBoxColumn からクラスを派生させて新しいプロパティを追加する場合は、Clone メソッドをオーバーライドして、クローン操作時に新しいプロパティをコピーする必要があります。また、基本クラスの Clone メソッドも呼び出して、基本クラスのプロパティが新しいセルにコピーされるようにする必要があります。

使用例

次のコード例は、DataGridViewCheckBoxColumn を使用して、外出している従業員をマークする方法を示しています。

Visual Basic

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

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);
}

C++

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);
    }

継承階層

System.Object
   System.Windows.Forms.DataGridViewElement
     System.Windows.Forms.DataGridViewBand
       System.Windows.Forms.DataGridViewColumn
        System.Windows.Forms.DataGridViewCheckBoxColumn

スレッドセーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッドセーフです。インスタンスメンバの場合は、スレッドセーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework

サポート対象 : 2.0

参照

.NET Framework

関連項目