DataGridViewCheckBoxCell クラス

定義

DataGridView コントロールで使用する、チェック ボックス ユーザー インターフェイス (UI) を表示します。

public ref class DataGridViewCheckBoxCell : System::Windows::Forms::DataGridViewCell, System::Windows::Forms::IDataGridViewEditingCell
public class DataGridViewCheckBoxCell : System.Windows.Forms.DataGridViewCell, System.Windows.Forms.IDataGridViewEditingCell
type DataGridViewCheckBoxCell = class
    inherit DataGridViewCell
    interface IDataGridViewEditingCell
Public Class DataGridViewCheckBoxCell
Inherits DataGridViewCell
Implements IDataGridViewEditingCell
継承
DataGridViewCheckBoxCell
実装

次のコード例では、 を DataGridViewCheckBoxColumn 使用して、オフィス内の従業員を追跡します。 列は オブジェクトで DataGridViewCheckBoxCell 構成されます。 この例は、クラスの概要に関するトピックで使用できる大きな例の 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

注釈

クラスはDataGridViewCheckBoxCell、チェック ボックス UI を介して表示されるバイナリまたは三項情報を表示するために使用される特殊な型DataGridViewCellです。 既定のバイナリ モードでは、セルは または falseの値をtrue保持できます。 三項モードでは、セルはいずれかの値を CheckState 受け取ります。 プロパティは ThreeState 、バイナリ モードと三項モードのどちらを有効にするかを決定します。

DataGridViewCheckBoxColumnは、この型のセルを保持するために特殊化された列型です。 既定では、 DataGridViewCheckBoxColumn.CellTemplate は新 DataGridViewCheckBoxCellしい に初期化されます。 既存 DataGridViewCheckBoxCellの の後の列内のセルをパターン設定するには、パターンとして使用するセルに列の CellTemplate プロパティを設定します。

列のセル関連プロパティは、テンプレート セルの同様の名前のプロパティのラッパーです。 テンプレート セルのプロパティ値を変更すると、変更後に追加されたテンプレートに基づくセルにのみ影響します。 ただし、列のセル関連のプロパティ値を変更すると、テンプレート セルと列内の他のすべてのセルが更新され、必要に応じて列の表示が更新されます。

現在のセルが の DataGridViewCheckBoxCell場合、 DataGridView.IsCurrentCellInEditMode プロパティは常に trueです。

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

注意 (継承者)

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

コンストラクター

DataGridViewCheckBoxCell()

DataGridViewCheckBoxCell クラスの新しいインスタンスを既定の状態に初期化します。

DataGridViewCheckBoxCell(Boolean)

DataGridViewCheckBoxCell クラスの新しいインスタンスを初期化して、2 進または 3 進状態を有効にします。

プロパティ

AccessibilityObject

DataGridViewCell.DataGridViewCellAccessibleObject に割り当てられた DataGridViewCell を取得します。

(継承元 DataGridViewCell)
ColumnIndex

このセルの列インデックスを取得します。

(継承元 DataGridViewCell)
ContentBounds

セルの内容領域を囲んだ外接する四角形を取得します。

(継承元 DataGridViewCell)
ContextMenuStrip

セルに関連付けられたショートカット メニューを取得または設定します。

(継承元 DataGridViewCell)
DataGridView

この要素に関連付けられている DataGridView コントロールを取得します。

(継承元 DataGridViewElement)
DefaultNewRowValue

新しいレコードの行のセルに対する既定値を取得します。

(継承元 DataGridViewCell)
Displayed

セルが現在画面上に表示されているかどうかを示す値を取得します。

(継承元 DataGridViewCell)
EditedFormattedValue

セルが編集モードであるかどうか、および値がコミットされているかどうかに関係なく、セルの現在の書式指定済みの値を取得します。

(継承元 DataGridViewCell)
EditingCellFormattedValue

編集モードのときにセルでホストされているコントロールの書式設定済みの値を取得または設定します。

EditingCellValueChanged

このセルの値が変更されたかどうかを示すフラグを取得または設定します。

EditType

セルのホストされる編集コントロールの型を取得します。

ErrorIconBounds

セルのエラー アイコンの境界を取得します。

(継承元 DataGridViewCell)
ErrorText

セルに関連付けられたエラー条件を記述するテキストを取得または設定します。

(継承元 DataGridViewCell)
FalseValue

false のセル値に対応する基底の値を取得または設定します。

FlatStyle

チェック ボックス ユーザー インターフェイス (UI) のフラット スタイルの外観を取得または設定します。

FormattedValue

表示用に書式指定済みのセル値を取得します。

(継承元 DataGridViewCell)
FormattedValueType

セルの表示値の型を取得します。

Frozen

セルが固定された状態かどうかを示す値を取得します。

(継承元 DataGridViewCell)
HasStyle

Style プロパティが設定されているかどうかを示す値を取得します。

(継承元 DataGridViewCell)
IndeterminateValue

不確定または null のセル値に対応する基底の値を取得または設定します。

InheritedState

行と列の状態から継承されたセルの現在の状態を取得します。

(継承元 DataGridViewCell)
InheritedStyle

セルに現在適用されているスタイルを取得します。

(継承元 DataGridViewCell)
IsInEditMode

このセルが現在編集されているかどうかを示す値を取得します。

(継承元 DataGridViewCell)
OwningColumn

セルを格納している列を取得します。

(継承元 DataGridViewCell)
OwningRow

セルを格納している行を取得します。

(継承元 DataGridViewCell)
PreferredSize

セルが収まる四角形領域のサイズをピクセル単位で取得します。

(継承元 DataGridViewCell)
ReadOnly

セルのデータを編集できるかどうかを示す値を取得または設定します。

(継承元 DataGridViewCell)
Resizable

セルのサイズを変更できるかどうかを示す値を取得します。

(継承元 DataGridViewCell)
RowIndex

セルの親行のインデックスを取得します。

(継承元 DataGridViewCell)
Selected

セルが選択されているかどうかを示す値を取得または設定します。

(継承元 DataGridViewCell)
Size

セルのサイズを取得します。

(継承元 DataGridViewCell)
State

要素のユーザー インターフェイス (UI) の状態を取得します。

(継承元 DataGridViewElement)
Style

セルのスタイルを取得または設定します。

(継承元 DataGridViewCell)
Tag

セルに関する補足的なデータを格納するオブジェクトを取得または設定します。

(継承元 DataGridViewCell)
ThreeState

ホストされているチェック ボックス コントロールの 3 進モードが有効になっているかどうかを示す値を取得または設定します。

ToolTipText

このセルに関連付けられているツールヒント テキストを取得または設定します。

(継承元 DataGridViewCell)
TrueValue

true のセル値に対応する基底の値を取得または設定します。

Value

このセルに関連付けられている値を取得または設定します。

(継承元 DataGridViewCell)
ValueType

セル内の値のデータ型を取得します。

Visible

非表示にされた行または列にセルが含まれるかどうかを示す値を取得します。

(継承元 DataGridViewCell)

メソッド

AdjustCellBorderStyle(DataGridViewAdvancedBorderStyle, DataGridViewAdvancedBorderStyle, Boolean, Boolean, Boolean, Boolean)

指定した条件に従って、入力セルの境界線スタイルを変更します。

(継承元 DataGridViewCell)
BorderWidths(DataGridViewAdvancedBorderStyle)

すべてのセル マージンの幅を表す Rectangle を返します。

(継承元 DataGridViewCell)
ClickUnsharesRow(DataGridViewCellEventArgs)

セルがクリックされたときに、セルの行の共有を解除するかどうかを示します。

(継承元 DataGridViewCell)
Clone()

対象のセルの同一コピーを作成します。

ContentClickUnsharesRow(DataGridViewCellEventArgs)

セルの内容がクリックされたときに、セルを含む行の共有を解除するかどうかを示します。

ContentDoubleClickUnsharesRow(DataGridViewCellEventArgs)

セルの内容がダブルクリックされたときに、セルを含む行の共有を解除するかどうかを示します。

CreateAccessibilityInstance()

DataGridViewCheckBoxCell の新しいユーザー補助オブジェクトを作成します。

DetachEditingControl()

セルの編集コントロールを DataGridView から削除します。

(継承元 DataGridViewCell)
Dispose()

DataGridViewCell によって使用されているすべてのリソースを解放します。

(継承元 DataGridViewCell)
Dispose(Boolean)

DataGridViewCell によって使用されているアンマネージド リソースを解放し、オプションでマネージド リソースも解放します。

(継承元 DataGridViewCell)
DoubleClickUnsharesRow(DataGridViewCellEventArgs)

セルがダブルクリックされたときに、セルの行の共有を解除するかどうかを示します。

(継承元 DataGridViewCell)
EnterUnsharesRow(Int32, Boolean)

フォーカスがセルに移動したときに、親の行を非共有にするかどうかを示します。

(継承元 DataGridViewCell)
Equals(Object)

指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。

(継承元 Object)
GetClipboardContent(Int32, Boolean, Boolean, Boolean, Boolean, String)

Clipboard にコピーするセルの書式指定済みの値を取得します。

(継承元 DataGridViewCell)
GetContentBounds(Graphics, DataGridViewCellStyle, Int32)

セルの内容領域に外接する四角形を返します。これは、指定された Graphics とセル スタイルを使って計算されます。

GetContentBounds(Int32)

既定の Graphics、およびセルに現在有効なセル スタイルを使用して、セルの内容領域を囲む外接する四角形を返します。

(継承元 DataGridViewCell)
GetEditedFormattedValue(Int32, DataGridViewDataErrorContexts)

セルが編集モードであるかどうか、および値がコミットされているかどうかに関係なく、セルの現在の書式指定済みの値を返します。

(継承元 DataGridViewCell)
GetEditingCellFormattedValue(DataGridViewDataErrorContexts)

編集モードのセルについて、書式設定済みの値を取得します。

GetErrorIconBounds(Graphics, DataGridViewCellStyle, Int32)

セルのエラー アイコンが表示されている場合に、そのエラー アイコンを囲む外接する四角形を返します。

GetErrorText(Int32)

セルのエラーを表す文字列を返します。

(継承元 DataGridViewCell)
GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts)

セルのデータの書式指定済みの値を取得します。

GetHashCode()

既定のハッシュ関数として機能します。

(継承元 Object)
GetInheritedContextMenuStrip(Int32)

現在のセルの継承されたショートカット メニューを取得します。

(継承元 DataGridViewCell)
GetInheritedState(Int32)

行および列の状態から継承されたセルの現在の状態を示す値を返します。

(継承元 DataGridViewCell)
GetInheritedStyle(DataGridViewCellStyle, Int32, Boolean)

セルに適用されるスタイルを取得します。

(継承元 DataGridViewCell)
GetPreferredSize(Graphics, DataGridViewCellStyle, Int32, Size)

セルの推奨されるサイズをピクセル単位で計算します。

GetSize(Int32)

セルのサイズを取得します。

(継承元 DataGridViewCell)
GetType()

現在のインスタンスの Type を取得します。

(継承元 Object)
GetValue(Int32)

セルの値を取得します。

(継承元 DataGridViewCell)
InitializeEditingControl(Int32, Object, DataGridViewCellStyle)

セルの編集に使用されるコントロールを初期化します。

(継承元 DataGridViewCell)
KeyDownUnsharesRow(KeyEventArgs, Int32)

セルにフォーカスがある状態でキーを押したときに、セルを含む行の共有が解除されるかどうかを示します。

KeyEntersEditMode(KeyEventArgs)

押されたキーに基づいて編集モードを開始するかどうかを決定します。

(継承元 DataGridViewCell)
KeyPressUnsharesRow(KeyPressEventArgs, Int32)

行内のセルにフォーカスがあるときにキーが押された場合に、行を非共有にするかどうかを示します。

(継承元 DataGridViewCell)
KeyUpUnsharesRow(KeyEventArgs, Int32)

セルにフォーカスがある状態でキーを離したときに、セルを含む行の共有が解除されるかどうかを示します。

LeaveUnsharesRow(Int32, Boolean)

フォーカスが行のセルを離れたときに、その行を非共有にするかどうかを示します。

(継承元 DataGridViewCell)
MemberwiseClone()

現在の Object の簡易コピーを作成します。

(継承元 Object)
MouseClickUnsharesRow(DataGridViewCellMouseEventArgs)

マウス ポインターを行のセルに置いた状態でマウス ボタンをクリックしたときに、その行を非共有にするかどうかを示します。

(継承元 DataGridViewCell)
MouseDoubleClickUnsharesRow(DataGridViewCellMouseEventArgs)

行内のセルをダブルクリックした場合に、その行を非共有にするかどうかを示します。

(継承元 DataGridViewCell)
MouseDownUnsharesRow(DataGridViewCellMouseEventArgs)

マウス ポインターがセルの上に配置されているときにマウス ボタンが押されると、そのセルを含む行の共有を解除するかどうかを示します。

MouseEnterUnsharesRow(Int32)

マウス ポインターをセルの上に配置したときに、そのセルを含む行の共有を解除するかどうかを示します。

MouseLeaveUnsharesRow(Int32)

マウス ポインターをセルから離したときに、そのセルを含む行の共有を解除するかどうかを示します。

MouseMoveUnsharesRow(DataGridViewCellMouseEventArgs)

マウス ポインターを行のセル上に移動したときに行の共有を解除するかどうかを示します。

(継承元 DataGridViewCell)
MouseUpUnsharesRow(DataGridViewCellMouseEventArgs)

マウス ポインターがセルの上に配置されているときにマウス ボタンを離すと、そのセルを含む行の共有を解除するかどうかを示します。

OnClick(DataGridViewCellEventArgs)

セルがクリックされたときに呼び出されます。

(継承元 DataGridViewCell)
OnContentClick(DataGridViewCellEventArgs)

セルの内容がクリックされたときに呼び出されます。

OnContentDoubleClick(DataGridViewCellEventArgs)

セルの内容がダブルクリックされたときに呼び出されます。

OnDataGridViewChanged()

セルの DataGridView プロパティが変更された場合に発生します。

(継承元 DataGridViewCell)
OnDoubleClick(DataGridViewCellEventArgs)

セルがダブルクリックされたときに呼び出されます。

(継承元 DataGridViewCell)
OnEnter(Int32, Boolean)

フォーカスがセルに移動するときに呼び出されます。

(継承元 DataGridViewCell)
OnKeyDown(KeyEventArgs, Int32)

セルにフォーカスがある状態で文字キーが押されたときに呼び出されます。

OnKeyPress(KeyPressEventArgs, Int32)

セルにフォーカスがある状態でキーが押されたときに呼び出されます。

(継承元 DataGridViewCell)
OnKeyUp(KeyEventArgs, Int32)

セルにフォーカスがある状態で文字キーを離したときに呼び出されます。

OnLeave(Int32, Boolean)

フォーカスがセルから離れるときに呼び出されます。

OnMouseClick(DataGridViewCellMouseEventArgs)

マウス ポインターがセル上にあるときにマウス ボタンをクリックすると呼び出されます。

(継承元 DataGridViewCell)
OnMouseDoubleClick(DataGridViewCellMouseEventArgs)

マウス ポインターがセル上にあるときにマウス ボタンをダブルクリックすると呼び出されます。

(継承元 DataGridViewCell)
OnMouseDown(DataGridViewCellMouseEventArgs)

マウス ポインターをセルに置いた状態でマウス ボタンを押し下げたときに呼び出されます。

OnMouseEnter(Int32)

マウス ポインターがセル上を移動すると呼び出されます。

(継承元 DataGridViewCell)
OnMouseLeave(Int32)

マウス ポインターがセルから離れると呼び出されます。

OnMouseMove(DataGridViewCellMouseEventArgs)

マウス ポインターがセル内で移動すると呼び出されます。

OnMouseUp(DataGridViewCellMouseEventArgs)

マウス ポインターをセルに置いた状態でマウス ボタンを離したときに呼び出されます。

Paint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Object, Object, String, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle, DataGridViewPaintParts)

現在の DataGridViewCheckBoxCell を描画します。

PaintBorder(Graphics, Rectangle, Rectangle, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle)

現在の DataGridViewCell の境界線を描画します。

(継承元 DataGridViewCell)
PaintErrorIcon(Graphics, Rectangle, Rectangle, String)

現在の DataGridViewCell のエラー アイコンを描画します。

(継承元 DataGridViewCell)
ParseFormattedValue(Object, DataGridViewCellStyle, TypeConverter, TypeConverter)

表示用に書式設定された値を、実際のセル値に変換します。

PositionEditingControl(Boolean, Boolean, Rectangle, Rectangle, DataGridViewCellStyle, Boolean, Boolean, Boolean, Boolean)

DataGridView コントロールのセルによってホストされる編集コントロールの位置とサイズを設定します。

(継承元 DataGridViewCell)
PositionEditingPanel(Rectangle, Rectangle, DataGridViewCellStyle, Boolean, Boolean, Boolean, Boolean)

セルによってホストされる編集パネルの位置とサイズを設定し、編集パネル内の編集コントロールの標準の境界を返します。

(継承元 DataGridViewCell)
PrepareEditingCellForEdit(Boolean)

この型では、このメソッドは無効です。

RaiseCellClick(DataGridViewCellEventArgs)

CellClick イベントを発生させます。

(継承元 DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)

CellContentClick イベントを発生させます。

(継承元 DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)

CellContentDoubleClick イベントを発生させます。

(継承元 DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)

CellValueChanged イベントを発生させます。

(継承元 DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)

DataError イベントを発生させます。

(継承元 DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)

MouseWheel イベントを発生させます。

(継承元 DataGridViewElement)
SetValue(Int32, Object)

セルの値を設定します。

(継承元 DataGridViewCell)
ToString()

セルの文字列形式を返します。

適用対象

こちらもご覧ください