DataGridView.InvalidateCell Méthode

Définition

Invalide une cellule dans le DataGridView, en la forçant à être redessinée.Invalidates a cell in the DataGridView, forcing it to be repainted.

Surcharges

InvalidateCell(DataGridViewCell)

Invalide la cellule spécifiée du DataGridView, en la forçant à être redessinée.Invalidates the specified cell of the DataGridView, forcing it to be repainted.

InvalidateCell(Int32, Int32)

Invalide la cellule avec les index de ligne et de colonne spécifiés, en la forçant à être redessinée.Invalidates the cell with the specified row and column indexes, forcing it to be repainted.

InvalidateCell(DataGridViewCell)

Invalide la cellule spécifiée du DataGridView, en la forçant à être redessinée.Invalidates the specified cell of the DataGridView, forcing it to be repainted.

public:
 void InvalidateCell(System::Windows::Forms::DataGridViewCell ^ dataGridViewCell);
public void InvalidateCell (System.Windows.Forms.DataGridViewCell dataGridViewCell);
member this.InvalidateCell : System.Windows.Forms.DataGridViewCell -> unit

Paramètres

dataGridViewCell
DataGridViewCell

DataGridViewCell à invalider.The DataGridViewCell to invalidate.

Exceptions

dataGridViewCell n’appartient pas à DataGridView.dataGridViewCell does not belong to the DataGridView.

dataGridViewCell a la valeur null.dataGridViewCell is null.

Exemples

L’exemple de code suivant illustre l’utilisation de cette méthode dans un DataGridViewCell personnalisé-0 qui est peint avec une bordure personnalisée lorsque le pointeur de la souris se trouve sur celui-ci.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. Dans l’exemple, la cellule est invalidée lorsque le pointeur de la souris entre ou le quitte.In the example, the cell is invalidated when the mouse pointer enters or leaves it.

Ce code fait partie d’un exemple plus complet disponible dans How à : Personnaliser les cellules et les colonnes dans le contrôle DataGridView Windows Forms en étendant leur comportement et leur apparence.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);
}
' Force the cell to repaint itself when the mouse pointer enters it.
Protected Overrides Sub OnMouseEnter(ByVal rowIndex As Integer)
    Me.DataGridView.InvalidateCell(Me)
End Sub

' Force the cell to repaint itself when the mouse pointer leaves it.
Protected Overrides Sub OnMouseLeave(ByVal rowIndex As Integer)
    Me.DataGridView.InvalidateCell(Me)
End Sub

Remarques

Cette méthode est utile pour forcer une redessine de cellule dans des conditions qui ne provoquent normalement pas la redessination d’une cellule.This method is useful to force a cell repaint in conditions that would not normally cause a cell to be repainted. Par exemple, vous pouvez utiliser cette méthode avec un type de cellule personnalisé qui modifie son apparence à la suite d’événements externes.For example, you can use this method with a custom cell type that changes its appearance as a result of external events.

Pour plus d’informations sur la peinture et l’invalidation, consultez Invalidate.For more information about painting and invalidation, see Invalidate.

Voir aussi

InvalidateCell(Int32, Int32)

Invalide la cellule avec les index de ligne et de colonne spécifiés, en la forçant à être redessinée.Invalidates the cell with the specified row and column indexes, forcing it to be repainted.

public:
 void InvalidateCell(int columnIndex, int rowIndex);
public void InvalidateCell (int columnIndex, int rowIndex);
member this.InvalidateCell : int * int -> unit
Public Sub InvalidateCell (columnIndex As Integer, rowIndex As Integer)

Paramètres

columnIndex
Int32

Index de colonne de la cellule à invalider.The column index of the cell to invalidate.

rowIndex
Int32

Index de ligne de la cellule à invalider.The row index of the cell to invalidate.

Exceptions

columnIndex est inférieur à -1 ou supérieur au nombre de colonnes dans le contrôle moins 1.columnIndex is less than -1 or greater than the number of columns in the control minus 1.

- ou --or- rowIndex est inférieur à -1 ou supérieur au nombre de lignes dans le contrôle moins 1.rowIndex is less than -1 or greater than the number of rows in the control minus 1.

Exemples

L’exemple de code suivant illustre l’utilisation de cette méthode dans un type de cellule personnalisé qui modifie l’apparence d’une cellule quand l’utilisateur place le pointeur de la souris dessus.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. Cet exemple fait partie d’un exemple plus complet disponible dans How à : Personnaliser les cellules et les colonnes dans le contrôle DataGridView Windows Forms en étendant leur comportement et leur apparence.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.

// 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);
}
' Force the cell to repaint itself when the mouse pointer enters it.
Protected Overrides Sub OnMouseEnter(ByVal rowIndex As Integer)
    Me.DataGridView.InvalidateCell(Me)
End Sub

' Force the cell to repaint itself when the mouse pointer leaves it.
Protected Overrides Sub OnMouseLeave(ByVal rowIndex As Integer)
    Me.DataGridView.InvalidateCell(Me)
End Sub

Remarques

Cette méthode est utile pour forcer une redessine de cellule dans des conditions qui ne provoquent normalement pas la redessination d’une cellule.This method is useful to force a cell repaint in conditions that would not normally cause a cell to be repainted. Par exemple, vous pouvez utiliser cette méthode avec un type de cellule personnalisé qui modifie son apparence à la suite d’événements externes.For example, you can use this method with a custom cell type that changes its appearance as a result of external events.

Pour plus d’informations sur la peinture et l’invalidation, consultez Invalidate.For more information about painting and invalidation, see Invalidate.

Voir aussi

S’applique à