DataGridView.RowEnter Event

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Occurs when a row receives input focus but before it becomes the current row.

public:
 event System::Windows::Forms::DataGridViewCellEventHandler ^ RowEnter;

public event System.Windows.Forms.DataGridViewCellEventHandler RowEnter;

member this.RowEnter : System.Windows.Forms.DataGridViewCellEventHandler 

Public Custom Event RowEnter As DataGridViewCellEventHandler 

Event Type

DataGridViewCellEventHandler

Examples

The following code example illustrates how to handle this event to change the BackColor property of the cells in the current row. In this example, the background color is set in the RowEnter event, then reset to Empty on the RowLeave 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_RowEnter(object sender, 
    DataGridViewCellEventArgs e)
{
    for (int i = 0; i < dataGridView1.Rows[e.RowIndex].Cells.Count; i++)
    {
        dataGridView1[i, e.RowIndex].Style.BackColor = Color.Yellow;
    }
}

private void dataGridView1_RowLeave(object sender, 
    DataGridViewCellEventArgs e)
{
    for (int i = 0; i < dataGridView1.Rows[e.RowIndex].Cells.Count; i++)
    {
        dataGridView1[i, e.RowIndex].Style.BackColor = Color.Empty;
    }
}

Private Sub dataGridView1_RowEnter(ByVal sender As Object, _
    ByVal e As DataGridViewCellEventArgs) _
    Handles dataGridView1.RowEnter

    Dim i As Integer
    For i = 0 To dataGridView1.Rows(e.RowIndex).Cells.Count - 1
        dataGridView1(i, e.RowIndex).Style _
            .BackColor = Color.Yellow
    Next i

End Sub

Private Sub dataGridView1_RowLeave(ByVal sender As Object, _
    ByVal e As DataGridViewCellEventArgs) _
    Handles dataGridView1.RowLeave

    Dim i As Integer
    For i = 0 To dataGridView1.Rows(e.RowIndex).Cells.Count - 1
        dataGridView1(i, e.RowIndex).Style _
            .BackColor = Color.Empty
    Next i

End Sub

Remarks

This event occurs when the DataGridView is initially loaded, as well as when the user selects a row other than the current row.

This event occurs before the CurrentRow property is updated. To retrieve the index of the newly-entered row, use the DataGridViewCellEventArgs.RowIndex property within the event handler.

For more information about how to handle events, see Handling and Raising Events.

See also

• DataGridView Control (Windows Forms)