DataGridView.CellClick イベント

.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

C#

public event DataGridViewCellEventHandler CellClick

C++

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

J#

/** @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

C#

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;
    }
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DataGridView クラス
DataGridView メンバ
System.Windows.Forms 名前空間
その他の技術情報
DataGridView コントロール (Windows フォーム)