DataGridView::InvalidateCell Method (DataGridViewCell^)

.NET Framework (current version)

Note
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)

Syntax

C++

public:
void InvalidateCell(
	DataGridViewCell^ dataGridViewCell
)

Parameters

dataGridViewCell: Type: System.Windows.Forms::DataGridViewCell^
The DataGridViewCell to invalidate.

Exceptions

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.

Examples

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.

C++

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

Version Information

.NET Framework
Available since 2.0