This topic has not yet been rated - Rate this topic

DataGridView::InvalidateCell Method (Int32, Int32)

.NET Framework 4.5

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.

Exceptions

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.

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.

Remarks

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.

Examples

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.

C++

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

Version Information

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Platforms

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Reference

DataGridView Class

InvalidateCell Overload

System.Windows.Forms Namespace

Invalidate

Other Resources

DataGridView Control (Windows Forms)

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)