DataGridView.CellEnter Event
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Occurs when the current cell changes in the DataGridView control or when the control receives input focus.
public:
event System::Windows::Forms::DataGridViewCellEventHandler ^ CellEnter;
public event System.Windows.Forms.DataGridViewCellEventHandler CellEnter;
public event System.Windows.Forms.DataGridViewCellEventHandler? CellEnter;
member this.CellEnter : System.Windows.Forms.DataGridViewCellEventHandler
Public Custom Event CellEnter As DataGridViewCellEventHandler
Event Type
Examples
The following code example illustrates how to handle this event to change the SelectionBackColor property of the current cell. In this example the selection background color is set in the CellEnter event, then reset to Empty on the CellLeave event. To run this example, paste the code into a form that contains a DataGridView named dataGridView1
and ensure that all events are associated with their event handlers.
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;
}
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
Remarks
This event may occur twice for a single click if the control does not have input focus and the clicked cell was not previously the current cell.
For more information about how to handle events, see Handling and Raising Events.