DataGridView::InvalidateCell Method (Int32, Int32)

 

Invalidates the cell with the specified row and column indexes, forcing it to be repainted.

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

public:
void InvalidateCell(
	int columnIndex,
	int rowIndex
)

Parameters

columnIndex
Type: System::Int32

The column index of the cell to invalidate.

rowIndex
Type: System::Int32

The row index of the cell to invalidate.

Exception Condition
ArgumentOutOfRangeException

columnIndex is less than -1 or greater than the number of columns in the control minus 1.

-or-

rowIndex is less than -1 or greater than the number of rows in the control minus 1.

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 custom cell type that changes a cell's appearance when the user rests the mouse pointer over it. This example 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.

No code example is currently available or this language may not be supported.

.NET Framework
Available since 2.0
Return to top
Show: