DataGridViewCheckBoxColumn DataGridViewCheckBoxColumn DataGridViewCheckBoxColumn DataGridViewCheckBoxColumn Class


DataGridViewCheckBoxCell オブジェクトのコレクションをホストします。Hosts a collection of DataGridViewCheckBoxCell objects.

public ref class DataGridViewCheckBoxColumn : System::Windows::Forms::DataGridViewColumn
[System.Drawing.ToolboxBitmap(typeof(System.Windows.Forms.DataGridViewCheckBoxColumn), "DataGridViewCheckBoxColumn.bmp")]
[System.Drawing.ToolboxBitmap(typeof(System.Windows.Forms.DataGridViewCheckBoxColumn), "DataGridViewCheckBoxColumn")]
public class DataGridViewCheckBoxColumn : System.Windows.Forms.DataGridViewColumn
type DataGridViewCheckBoxColumn = class
    inherit DataGridViewColumn
Public Class DataGridViewCheckBoxColumn
Inherits DataGridViewColumn

次のコード例は、をDataGridViewCheckBoxColumn使用して、どの従業員がオフィスにいないかを示す方法を示しています。The following code example demonstrates how to use a DataGridViewCheckBoxColumn to mark which employees are out of the office. この例は、クラスの概要に関するトピックでDataGridViewComboBoxColumn紹介されている大規模な例の一部です。This example is part of a larger example available in the DataGridViewComboBoxColumn class overview topic.

    void AddOutOfOfficeColumn()
        DataGridViewCheckBoxColumn^ column = gcnew DataGridViewCheckBoxColumn();
            column->HeaderText = ColumnName::OutOfOffice.ToString();
            column->Name = ColumnName::OutOfOffice.ToString();
            column->AutoSizeMode = 
            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 = 
        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


クラスは、バイナリ状態を示すセルDataGridViewColumnを論理的にホストするために使用されるクラスの特殊な型です。 DataGridViewCheckBoxColumnThe DataGridViewCheckBoxColumn class is a specialized type of the DataGridViewColumn class used to logically host cells that indicate binary state. DataGridViewCheckBoxColumn 、と交差DataGridViewCheckBoxCellするすべてDataGridViewRowのに関連付けられています。A DataGridViewCheckBoxColumn has an associated DataGridViewCheckBoxCell in every DataGridViewRow that intersects it. 各セルには、 CheckBoxコントロールに似たユーザーインターフェイス (UI) が用意されています。Each cell supplies a user interface (UI) that is similar to a CheckBox control.

この列の種類の既定の並べ替えモードNotSortableはです。The default sort mode for this column type is NotSortable.

通常、チェックボックスのセル値は、他のデータと同様にストレージ用、または一括操作を実行する目的で使用されます。Typically, check box cell values are intended either for storage, like any other data, or for performing bulk operations. ユーザーがチェックボックスのセルをクリックしたときにすぐに応答する場合はDataGridView.CellContentClick 、イベントを処理できますが、このイベントはセルの値が更新される前に発生します。If you want to respond immediately when users click a check box cell, you can handle the DataGridView.CellContentClick event, but this event occurs before the cell value is updated. クリック時に新しい値が必要な場合は、現在の値に基づいて期待される値を計算する方法があります。If you need the new value at the time of the click, one option is to calculate what the expected value will be based on the current value. もう1つの方法は、変更を直ちにDataGridView.CellValueChangedコミットし、応答するイベントを処理することです。Another approach is to commit the change immediately, and handle the DataGridView.CellValueChanged event to respond to it. セルがクリックされたときに変更をコミットするにはDataGridView.CurrentCellDirtyStateChanged 、イベントを処理する必要があります。To commit the change when the cell is clicked, you must handle the DataGridView.CurrentCellDirtyStateChanged event. ハンドラーで、現在のセルがチェックボックスセルの場合は、 DataGridView.CommitEditメソッドを呼び出し、 Commit値を渡します。In the handler, if the current cell is a check box cell, call the DataGridView.CommitEdit method and pass in the Commit value.

注意 (継承者)

からDataGridViewCheckBoxColumn派生し、派生クラスに新しいプロパティを追加する場合は、複製操作中Clone()に新しいプロパティをコピーするようにメソッドをオーバーライドしてください。When you derive from DataGridViewCheckBoxColumn and add new properties to the derived class, be sure to override the Clone() method to copy the new properties during cloning operations. また、基本クラスのClone()メソッドを呼び出して、基底クラスのプロパティが新しいセルにコピーされるようにする必要があります。You should also call the base class's Clone() method so that the properties of the base class are copied to the new cell.


DataGridViewCheckBoxColumn() DataGridViewCheckBoxColumn() DataGridViewCheckBoxColumn() DataGridViewCheckBoxColumn()

DataGridViewCheckBoxColumn クラスの新しいインスタンスを既定の状態に初期化します。Initializes a new instance of the DataGridViewCheckBoxColumn class to the default state.

DataGridViewCheckBoxColumn(Boolean) DataGridViewCheckBoxColumn(Boolean) DataGridViewCheckBoxColumn(Boolean) DataGridViewCheckBoxColumn(Boolean)

DataGridViewCheckBoxColumn の新しいインスタンスを初期化し、2 つまたは 3 つの状態を持つチェック ボックスを表示するように構成します。Initializes a new instance of the DataGridViewCheckBoxColumn and configures it to display check boxes with two or three states.


AutoSizeMode AutoSizeMode AutoSizeMode AutoSizeMode

列の幅を自動的に調整するときに使用するモードを取得または設定します。Gets or sets the mode by which the column automatically adjusts its width.

(Inherited from DataGridViewColumn)
CellTemplate CellTemplate CellTemplate CellTemplate

新しいセルの作成に使用するテンプレートを取得または設定します。Gets or sets the template used to create new cells.

CellType CellType CellType CellType

セル テンプレートのランタイム型を取得します。Gets the run-time type of the cell template.

(Inherited from DataGridViewColumn)
ContextMenuStrip ContextMenuStrip ContextMenuStrip ContextMenuStrip

列のショートカット メニューを取得または設定します。Gets or sets the shortcut menu for the column.

(Inherited from DataGridViewColumn)
DataGridView DataGridView DataGridView DataGridView

この要素に関連付けられている DataGridView コントロールを取得します。Gets the DataGridView control associated with this element.

(Inherited from DataGridViewElement)
DataPropertyName DataPropertyName DataPropertyName DataPropertyName

DataGridViewColumn がバインドされている、データ ソース プロパティの名前またはデータベースの列の名前を取得または設定します。Gets or sets the name of the data source property or database column to which the DataGridViewColumn is bound.

(Inherited from DataGridViewColumn)
DefaultCellStyle DefaultCellStyle DefaultCellStyle DefaultCellStyle

列の既定のセル スタイルを取得または設定します。Gets or sets the column's default cell style.

DefaultHeaderCellType DefaultHeaderCellType DefaultHeaderCellType DefaultHeaderCellType

既定のヘッダー セルのランタイム型を取得または設定します。Gets or sets the run-time type of the default header cell.

(Inherited from DataGridViewBand)
Displayed Displayed Displayed Displayed

バンドが現在画面に表示されているかどうかを示す値を取得します。Gets a value indicating whether the band is currently displayed onscreen.

(Inherited from DataGridViewBand)
DisplayIndex DisplayIndex DisplayIndex DisplayIndex

現在表示されている列を基準とした列の表示順序を設定または取得します。Gets or sets the display order of the column relative to the currently displayed columns.

(Inherited from DataGridViewColumn)
DividerWidth DividerWidth DividerWidth DividerWidth

列の区分線の幅 (ピクセル数) を取得または設定します。Gets or sets the width, in pixels, of the column divider.

(Inherited from DataGridViewColumn)
FalseValue FalseValue FalseValue FalseValue

セル値が false の場合 (チェック ボックスがオフの状態で表示される場合) に対応する基になる値を取得または設定します。Gets or sets the underlying value corresponding to a cell value of false, which appears as an unchecked box.

FillWeight FillWeight FillWeight FillWeight

列が、コントロール内の他の塗りつぶしモードの列の幅を基準とする塗りつぶしモードの場合、列の幅を表す値を取得または設定します。Gets or sets a value that represents the width of the column when it is in fill mode relative to the widths of other fill-mode columns in the control.

(Inherited from DataGridViewColumn)
FlatStyle FlatStyle FlatStyle FlatStyle

チェック ボックス セルのフラット スタイルの外観を取得または設定します。Gets or sets the flat style appearance of the check box cells.

Frozen Frozen Frozen Frozen

ユーザーが DataGridView コントロールを水平方向にスクロールしたときに列が移動するかどうかを示す値を取得または設定します。Gets or sets a value indicating whether a column will move when a user scrolls the DataGridView control horizontally.

(Inherited from DataGridViewColumn)
HasDefaultCellStyle HasDefaultCellStyle HasDefaultCellStyle HasDefaultCellStyle

DefaultCellStyle プロパティが設定されているかどうかを示す値を取得します。Gets a value indicating whether the DefaultCellStyle property has been set.

(Inherited from DataGridViewBand)
HeaderCell HeaderCell HeaderCell HeaderCell

列ヘッダーを表す DataGridViewColumnHeaderCell を取得または設定します。Gets or sets the DataGridViewColumnHeaderCell that represents the column header.

(Inherited from DataGridViewColumn)
HeaderCellCore HeaderCellCore HeaderCellCore HeaderCellCore

DataGridViewBand のヘッダー セルを取得または設定します。Gets or sets the header cell of the DataGridViewBand.

(Inherited from DataGridViewBand)
HeaderText HeaderText HeaderText HeaderText

列のヘッダー セルのキャプション テキストを取得または設定します。Gets or sets the caption text on the column's header cell.

(Inherited from DataGridViewColumn)
IndeterminateValue IndeterminateValue IndeterminateValue IndeterminateValue

セル値が不確定状態または null の場合 (チェック ボックスがオフの状態で表示される場合) に対応する基になる値を取得または設定します。Gets or sets the underlying value corresponding to an indeterminate or null cell value, which appears as a disabled checkbox.

Index Index Index Index

DataGridView コントロール内のバンドの相対位置を取得します。Gets the relative position of the band within the DataGridView control.

(Inherited from DataGridViewBand)
InheritedAutoSizeMode InheritedAutoSizeMode InheritedAutoSizeMode InheritedAutoSizeMode

列に対して有効なサイズ変更モードを取得します。Gets the sizing mode in effect for the column.

(Inherited from DataGridViewColumn)
InheritedStyle InheritedStyle InheritedStyle InheritedStyle

列に現在適用されているセル スタイルを取得します。Gets the cell style currently applied to the column.

(Inherited from DataGridViewColumn)
IsDataBound IsDataBound IsDataBound IsDataBound

列がデータ ソースにバインドされているかどうかを示す値を取得します。Gets a value indicating whether the column is bound to a data source.

(Inherited from DataGridViewColumn)
IsRow IsRow IsRow IsRow

バンドが行を表すかどうかを示す値を取得します。Gets a value indicating whether the band represents a row.

(Inherited from DataGridViewBand)
MinimumWidth MinimumWidth MinimumWidth MinimumWidth

列の最小幅をピクセル単位で取得または設定します。Gets or sets the minimum width, in pixels, of the column.

(Inherited from DataGridViewColumn)
Name Name Name Name

列の名前を取得または設定します。Gets or sets the name of the column.

(Inherited from DataGridViewColumn)
ReadOnly ReadOnly ReadOnly ReadOnly

ユーザーが列のセルを編集できるかどうかを示す値を取得または設定します。Gets or sets a value indicating whether the user can edit the column's cells.

(Inherited from DataGridViewColumn)
Resizable Resizable Resizable Resizable

列のサイズを変更できるかどうかを示す値を取得または設定します。Gets or sets a value indicating whether the column is resizable.

(Inherited from DataGridViewColumn)
Selected Selected Selected Selected

バンドが、選択されたユーザー インターフェイス (UI) 状態かどうかを示す値を取得または設定します。Gets or sets a value indicating whether the band is in a selected user interface (UI) state.

(Inherited from DataGridViewBand)
Site Site Site Site

列のサイトを取得または設定します。Gets or sets the site of the column.

(Inherited from DataGridViewColumn)
SortMode SortMode SortMode SortMode

列の並べ替えモードを取得または設定します。Gets or sets the sort mode for the column.

(Inherited from DataGridViewColumn)
State State State State

要素のユーザー インターフェイス (UI) の状態を取得します。Gets the user interface (UI) state of the element.

(Inherited from DataGridViewElement)
Tag Tag Tag Tag

バンドに関連付けられているデータを含むオブジェクトを取得または設定します。Gets or sets the object that contains data to associate with the band.

(Inherited from DataGridViewBand)
ThreeState ThreeState ThreeState ThreeState

ホストされているチェック ボックス セルで 2 種類ではなく 3 種類のチェック状態を表示できるかどうかを示す値を取得または設定します。Gets or sets a value indicating whether the hosted check box cells will allow three check states rather than two.

ToolTipText ToolTipText ToolTipText ToolTipText

ツールヒントに使用されるテキストを取得または設定します。Gets or sets the text used for ToolTips.

(Inherited from DataGridViewColumn)
TrueValue TrueValue TrueValue TrueValue

セル値が true の場合 (チェック ボックスがオンの状態で表示される場合) に対応する基になる値を取得または設定します。Gets or sets the underlying value corresponding to a cell value of true, which appears as a checked box.

ValueType ValueType ValueType ValueType

列のセルの値のデータ型を取得または設定します。Gets or sets the data type of the values in the column's cells.

(Inherited from DataGridViewColumn)
Visible Visible Visible Visible

列を表示するかどうかを示す値を取得または設定します。Gets or sets a value indicating whether the column is visible.

(Inherited from DataGridViewColumn)
Width Width Width Width

列の現在の幅を取得または設定します。Gets or sets the current width of the column.

(Inherited from DataGridViewColumn)


Clone() Clone() Clone() Clone()

このバンドの同一コピーを作成します。Creates an exact copy of this band.

(Inherited from DataGridViewColumn)
Dispose() Dispose() Dispose() Dispose()

DataGridViewBand によって使用されているすべてのリソースを解放します。Releases all resources used by the DataGridViewBand.

(Inherited from DataGridViewBand)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

DataGridViewBand によって使用されているアンマネージド リソースを解放し、オプションでマネージド リソースも解放します。Releases the unmanaged resources used by the DataGridViewBand and optionally releases the managed resources.

(Inherited from DataGridViewColumn)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetPreferredWidth(DataGridViewAutoSizeColumnMode, Boolean) GetPreferredWidth(DataGridViewAutoSizeColumnMode, Boolean) GetPreferredWidth(DataGridViewAutoSizeColumnMode, Boolean) GetPreferredWidth(DataGridViewAutoSizeColumnMode, Boolean)

指定した基準に基づいて、列の適切な幅を計算します。Calculates the ideal width of the column based on the specified criteria.

(Inherited from DataGridViewColumn)
GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
OnDataGridViewChanged() OnDataGridViewChanged() OnDataGridViewChanged() OnDataGridViewChanged()

バンドが別の DataGridView に関連付けられている場合に呼び出されます。Called when the band is associated with a different DataGridView.

(Inherited from DataGridViewBand)
RaiseCellClick(DataGridViewCellEventArgs) RaiseCellClick(DataGridViewCellEventArgs) RaiseCellClick(DataGridViewCellEventArgs) RaiseCellClick(DataGridViewCellEventArgs)

CellClick イベントを発生させます。Raises the CellClick event.

(Inherited from DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs) RaiseCellContentClick(DataGridViewCellEventArgs) RaiseCellContentClick(DataGridViewCellEventArgs) RaiseCellContentClick(DataGridViewCellEventArgs)

CellContentClick イベントを発生させます。Raises the CellContentClick event.

(Inherited from DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs) RaiseCellContentDoubleClick(DataGridViewCellEventArgs) RaiseCellContentDoubleClick(DataGridViewCellEventArgs) RaiseCellContentDoubleClick(DataGridViewCellEventArgs)

CellContentDoubleClick イベントを発生させます。Raises the CellContentDoubleClick event.

(Inherited from DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs) RaiseCellValueChanged(DataGridViewCellEventArgs) RaiseCellValueChanged(DataGridViewCellEventArgs) RaiseCellValueChanged(DataGridViewCellEventArgs)

CellValueChanged イベントを発生させます。Raises the CellValueChanged event.

(Inherited from DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs) RaiseDataError(DataGridViewDataErrorEventArgs) RaiseDataError(DataGridViewDataErrorEventArgs) RaiseDataError(DataGridViewDataErrorEventArgs)

DataError イベントを発生させます。Raises the DataError event.

(Inherited from DataGridViewElement)
RaiseMouseWheel(MouseEventArgs) RaiseMouseWheel(MouseEventArgs) RaiseMouseWheel(MouseEventArgs) RaiseMouseWheel(MouseEventArgs)

MouseWheel イベントを発生させます。Raises the MouseWheel event.

(Inherited from DataGridViewElement)
ToString() ToString() ToString() ToString()

列を説明する文字列を取得します。Gets a string that describes the column.


Disposed Disposed Disposed Disposed

DataGridViewColumn が破棄されたときに発生します。Occurs when the DataGridViewColumn is disposed.

(Inherited from DataGridViewColumn)