DataGridViewCheckBoxCell クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
DataGridView コントロールで使用する、チェック ボックス ユーザー インターフェイス (UI) を表示します。
public ref class DataGridViewCheckBoxCell : System::Windows::Forms::DataGridViewCell, System::Windows::Forms::IDataGridViewEditingCellpublic class DataGridViewCheckBoxCell : System.Windows.Forms.DataGridViewCell, System.Windows.Forms.IDataGridViewEditingCelltype DataGridViewCheckBoxCell = class
inherit DataGridViewCell
interface IDataGridViewEditingCellPublic Class DataGridViewCheckBoxCell
Inherits DataGridViewCell
Implements IDataGridViewEditingCell- 継承
- 実装
例
次のコード例では、 を 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 |
|
| FlatStyle |
チェック ボックス ユーザー インターフェイス (UI) のフラット スタイルの外観を取得または設定します。 |
| FormattedValue |
表示用に書式指定済みのセル値を取得します。 (継承元 DataGridViewCell) |
| FormattedValueType |
セルの表示値の型を取得します。 |
| Frozen |
セルが固定された状態かどうかを示す値を取得します。 (継承元 DataGridViewCell) |
| HasStyle |
Style プロパティが設定されているかどうかを示す値を取得します。 (継承元 DataGridViewCell) |
| IndeterminateValue |
不確定または |
| 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 |
|
| Value |
このセルに関連付けられている値を取得または設定します。 (継承元 DataGridViewCell) |
| ValueType |
セル内の値のデータ型を取得します。 |
| Visible |
非表示にされた行または列にセルが含まれるかどうかを示す値を取得します。 (継承元 DataGridViewCell) |
メソッド
適用対象
こちらもご覧ください
.NET