DataGridView.CellClick イベントとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

DataGridView.CellClick イベント

メモ : このイベントは、.NET Framework version 2.0 で新しく追加されたものです。

セルの一部がクリックされた場合に発生します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Event CellClick As
 DataGridViewCellEventHandler

Visual Basic (使用法)

Dim instance As DataGridView
Dim handler As DataGridViewCellEventHandler

AddHandler instance.CellClick, handler

public event DataGridViewCellEventHandler CellClick

C++

public:
event DataGridViewCellEventHandler^ CellClick {
    void add (DataGridViewCellEventHandler^ value);
    void remove (DataGridViewCellEventHandler^ value);
}

/** @event */
public void add_CellClick (DataGridViewCellEventHandler
 value)

/** @event */
public void remove_CellClick (DataGridViewCellEventHandler
 value)

JScript

JScript では、イベントは使用できますが、新規に宣言することはできません。

解説

このイベントは、セルの一部 (境界線および埋め込みを含む) をクリックしたときに発生します。ボタンセルまたはチェックボックスセルにフォーカスがある状態で Space キーを押し、離したときにも発生します。また、これらのセルタイプでは、Space キーを押しながらセルをクリックした場合は、このイベントが 2 回発生します。

セルの内容がいつクリックされたかを判断するには、CellContentClick イベントを処理します。

このイベントは、マウスの位置に関する情報を受け取りません。イベントハンドラがマウスの位置に関する情報を必要とする場合は、CellMouseClick イベントを使用します。

DataGridViewCheckBoxCell をクリックすると、このイベントは、チェックボックスが値を変更する前に発生します。したがって、現在の値に基づいて予期される値を計算する必要がない場合、通常はこのイベントの代わりに DataGridView.CellValueChanged イベントを処理します。このイベントは、ユーザー指定の値がコミットされたとき (通常はフォーカスがセルを離れたとき) にだけ発生するため、DataGridView.CurrentCellDirtyStateChanged イベントも処理する必要があります。そのハンドラでは、現在のセルがチェックボックスセルの場合、DataGridView.CommitEdit メソッドを呼び出して、Commit 値を渡します。

イベント処理の詳細については、「イベントの利用」を参照してください。

使用例

DataGridView コントロール内のイメージ列を使用する Tic-Tac-Toe ゲーム実装における CellClick イベントハンドラを次のコード例に示します。ゲームが終わっていないか、セルがまだクリックされていない場合、イベントハンドラはセルの値を変数 x および o で表される 2 つの Bitmap オブジェクトの 1 つに設定します。

ここに示すコードは、「方法 : Windows フォーム DataGridView コントロールのイメージ列を操作する」に示すコードの一部です。

Visual Basic

Private Sub dataGridView1_CellClick(ByVal
 sender As Object, _
    ByVal e As DataGridViewCellEventArgs) _
    Handles dataGridView1.CellClick

    If turn.Text.Equals(gameOverString) Then
 Return

    Dim cell As DataGridViewImageCell = _
        CType(dataGridView1.Rows(e.RowIndex). _
            Cells(e.ColumnIndex), DataGridViewImageCell)
    If (cell.Value Is blank) Then
        If IsOsTurn() Then
            cell.Value = o
        Else
            cell.Value = x
        End If
        ToggleTurn()
        ToolTip(e)
    End If
    If IsAWin() Then
        turn.Text = gameOverString
    End If
End Sub

private void dataGridView1_CellClick(object
 sender,
    DataGridViewCellEventArgs e)
{

    if (turn.Text.Equals(gameOverString)) { return;
 }

    DataGridViewImageCell cell = (DataGridViewImageCell)
        dataGridView1.Rows[e.RowIndex].Cells[e.ColumnIndex];

    if (cell.Value == blank)
    {
        if (IsOsTurn())
        {
            cell.Value = o;
        }
        else
        {
            cell.Value = x;
        }
        ToggleTurn();
    }
    if (IsAWin())
    {
        turn.Text = gameOverString;
    }
}