DataGridView.CellEnter イベント

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

DataGridView.CellEnter イベント

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

DataGridView コントロールで現在のセルが変更されたとき、またはこのコントロールが入力フォーカスを受け取ったときに発生します。

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

Visual Basic (宣言)

Public Event CellEnter As
 DataGridViewCellEventHandler

Visual Basic (使用法)

Dim instance As DataGridView
Dim handler As DataGridViewCellEventHandler

AddHandler instance.CellEnter, handler

C#

public event DataGridViewCellEventHandler CellEnter

C++

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

J#

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

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

JScript

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

解説

コントロールに入力フォーカスがなく、クリックされたセルが以前に現在のセルではなかった場合、このイベントが 1 回のクリックに対して 2 回発生することがあります。

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

使用例

このイベントを処理して、現在のセルの SelectionBackColor プロパティを変更する方法を次のコード例に示します。この例では、背景色の選択は CellEnter イベントで設定され、CellLeave イベントで Empty にリセットされます。この例を実行するには、dataGridView1 という名前の DataGridView が配置されているフォームにコードを貼り付け、すべてのイベントを確実にイベント ハンドラに関連付けます。

Visual Basic

Private Sub dataGridView1_CellEnter(ByVal
 sender As Object, _
    ByVal e As DataGridViewCellEventArgs) _
    Handles dataGridView1.CellEnter

    dataGridView1(e.ColumnIndex, e.RowIndex).Style _
        .SelectionBackColor = Color.Blue

End Sub

Private Sub dataGridView1_CellLeave(ByVal
 sender As Object, _
    ByVal e As DataGridViewCellEventArgs) _
    Handles dataGridView1.CellLeave

    dataGridView1(e.ColumnIndex, e.RowIndex).Style _
        .SelectionBackColor = Color.Empty

End Sub

C#

private void dataGridView1_CellEnter(object
 sender, 
    DataGridViewCellEventArgs e)
{
    dataGridView1[e.ColumnIndex, e.RowIndex].Style
        .SelectionBackColor = Color.Blue;
}

private void dataGridView1_CellLeave(object
 sender, 
    DataGridViewCellEventArgs e)
{
    dataGridView1[e.ColumnIndex, e.RowIndex].Style
        .SelectionBackColor = Color.Empty;
}

プラットフォーム

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 フォーム)