DataGridViewCheckBoxColumn クラス

定義

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.

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 クラスの特殊な型です。The DataGridViewCheckBoxColumn class is a specialized type of the DataGridViewColumn class used to logically host cells that indicate binary state. DataGridViewCheckBoxColumn には、それと交差するすべての DataGridViewRow に関連付けられた DataGridViewCheckBoxCell があります。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 クラスの新しいインスタンスを既定の状態に初期化します。Initializes a new instance of the DataGridViewCheckBoxColumn class to the default state.

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

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

(継承元 DataGridViewColumn)
CellTemplate

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

CellType

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

(継承元 DataGridViewColumn)
ContextMenuStrip

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

(継承元 DataGridViewColumn)
DataGridView

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

(継承元 DataGridViewElement)
DataPropertyName

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

(継承元 DataGridViewColumn)
DefaultCellStyle

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

DefaultHeaderCellType

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

(継承元 DataGridViewBand)
Displayed

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

(継承元 DataGridViewBand)
DisplayIndex

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

(継承元 DataGridViewColumn)
DividerWidth

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

(継承元 DataGridViewColumn)
FalseValue

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

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.

(継承元 DataGridViewColumn)
FlatStyle

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

Frozen

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

(継承元 DataGridViewColumn)
HasDefaultCellStyle

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

(継承元 DataGridViewBand)
HeaderCell

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

(継承元 DataGridViewColumn)
HeaderCellCore

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

(継承元 DataGridViewBand)
HeaderText

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

(継承元 DataGridViewColumn)
IndeterminateValue

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

Index

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

(継承元 DataGridViewBand)
InheritedAutoSizeMode

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

(継承元 DataGridViewColumn)
InheritedStyle

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

(継承元 DataGridViewColumn)
IsDataBound

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

(継承元 DataGridViewColumn)
IsRow

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

(継承元 DataGridViewBand)
MinimumWidth

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

(継承元 DataGridViewColumn)
Name

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

(継承元 DataGridViewColumn)
ReadOnly

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

(継承元 DataGridViewColumn)
Resizable

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

(継承元 DataGridViewColumn)
Selected

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

(継承元 DataGridViewBand)
Site

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

(継承元 DataGridViewColumn)
SortMode

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

(継承元 DataGridViewColumn)
State

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

(継承元 DataGridViewElement)
Tag

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

(継承元 DataGridViewBand)
ThreeState

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

ToolTipText

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

(継承元 DataGridViewColumn)
TrueValue

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

ValueType

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

(継承元 DataGridViewColumn)
Visible

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

(継承元 DataGridViewColumn)
Width

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

(継承元 DataGridViewColumn)

メソッド

Clone()

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

(継承元 DataGridViewColumn)
Dispose()

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

(継承元 DataGridViewBand)
Dispose(Boolean)

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

(継承元 DataGridViewColumn)
Equals(Object)

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

(継承元 Object)
GetHashCode()

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

(継承元 Object)
GetPreferredWidth(DataGridViewAutoSizeColumnMode, Boolean)

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

(継承元 DataGridViewColumn)
GetType()

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

(継承元 Object)
MemberwiseClone()

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

(継承元 Object)
OnDataGridViewChanged()

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

(継承元 DataGridViewBand)
RaiseCellClick(DataGridViewCellEventArgs)

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

(継承元 DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)

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

(継承元 DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)

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

(継承元 DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)

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

(継承元 DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)

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

(継承元 DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)

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

(継承元 DataGridViewElement)
ToString()

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

イベント

Disposed

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

(継承元 DataGridViewColumn)

適用対象

こちらもご覧ください