DataGridView.InvalidateCell Method (DataGridViewCell)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Invalidates the specified cell of the DataGridView, forcing it to be repainted.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public void InvalidateCell(
	DataGridViewCell dataGridViewCell
)

Parameters

dataGridViewCell
Type: System.Windows.Forms.DataGridViewCell

The DataGridViewCell to invalidate.

Exception Condition
ArgumentException

dataGridViewCell does not belong to the DataGridView.

ArgumentNullException

dataGridViewCell is null.

This method is useful to force a cell repaint in conditions that would not normally cause a cell to be repainted. For example, you can use this method with a custom cell type that changes its appearance as a result of external events.

For more information about painting and invalidation, see Invalidate.

The following code example illustrates how to use this method in a customized DataGridViewCell that is painted with a custom border when the mouse pointer rests on it. In the example, the cell is invalidated when the mouse pointer enters or leaves it.

This code is part of a larger example available in How to: Customize Cells and Columns in the Windows Forms DataGridView Control by Extending Their Behavior and Appearance.

// Force the cell to repaint itself when the mouse pointer enters it.
protected override void OnMouseEnter(int rowIndex)
{
    this.DataGridView.InvalidateCell(this);
}

// Force the cell to repaint itself when the mouse pointer leaves it.
protected override void OnMouseLeave(int rowIndex)
{
    this.DataGridView.InvalidateCell(this);
}

.NET Framework
Available since 2.0
Return to top
Show: