DataGridViewCheckBoxColumn クラス

リファレンス

定義

名前空間:: System.Windows.Forms

アセンブリ:: System.Windows.Forms.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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

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には、そのと交差するすべての DataGridViewRow にが関連付けられていますDataGridViewCheckBoxCell。各セルには、コントロールに似た CheckBox ユーザーインターフェイス (UI) が用意されています。

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

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

注意 (継承者)

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

コンストラクター

DataGridViewCheckBoxColumn()	DataGridViewCheckBoxColumn クラスの新しいインスタンスを既定の状態に初期化します。
DataGridViewCheckBoxColumn(Boolean)	DataGridViewCheckBoxColumn の新しいインスタンスを初期化し、2 つまたは 3 つの状態を持つチェックボックスを表示するように構成します。

プロパティ

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	ホストされているチェックボックスセルで 2 種類ではなく 3 種類のチェック状態を表示できるかどうかを示す値を取得または設定します。
ToolTipText	ツールヒントに使用されるテキストを取得または設定します。 (継承元 DataGridViewColumn)
TrueValue	セル値が `true` の場合 (チェックボックスがオンの状態で表示される場合) に対応する基になる値を取得または設定します。
ValueType	列のセルの値のデータ型を取得または設定します。 (継承元 DataGridViewColumn)
Visible	列が表示されているかどうかを示す値を取得または設定します。 (継承元 DataGridViewColumn)
Width	列の現在の幅を取得または設定します。 (継承元 DataGridViewColumn)

メソッド

Clone()	このバンドの同一コピーを作成します。 (継承元 DataGridViewColumn)
Dispose()	DataGridViewBand によって使用されているすべてのリソースを解放します。 (継承元 DataGridViewBand)
Dispose(Boolean)	DataGridViewBand によって使用されているアンマネージドリソースを解放し、オプションでマネージドリソースも解放します。 (継承元 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

DataGridViewColumn が破棄されたときに発生します。

(継承元 DataGridViewColumn)

適用対象

次の方法で共有