DataGridView.InvalidateCell Méthode

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Invalide une cellule dans le DataGridView, en la forçant à être redessinée.

Surcharges

InvalidateCell(DataGridViewCell)	Invalide la cellule spécifiée du DataGridView, en la forçant à être redessinée.
InvalidateCell(Int32, Int32)	Invalide la cellule avec les index de ligne et de colonne spécifiés, en la forçant à être redessinée.

InvalidateCell(DataGridViewCell)

Invalide la cellule spécifiée du DataGridView, en la forçant à être redessinée.

public:
 void InvalidateCell(System::Windows::Forms::DataGridViewCell ^ dataGridViewCell);

public void InvalidateCell (System.Windows.Forms.DataGridViewCell dataGridViewCell);

member this.InvalidateCell : System.Windows.Forms.DataGridViewCell -> unit

Public Sub InvalidateCell (dataGridViewCell As DataGridViewCell)

Paramètres

dataGridViewCell

DataGridViewCell

DataGridViewCell à invalider.

Exceptions

ArgumentException

dataGridViewCell n’appartient pas à DataGridView.

ArgumentNullException

dataGridViewCell a la valeur null.

Exemples

L’exemple de code suivant montre comment utiliser cette méthode dans une méthode personnalisée DataGridViewCell qui est peinte avec une bordure personnalisée lorsque le pointeur de la souris repose dessus. Dans l’exemple, la cellule est invalidée lorsque le pointeur de la souris entre ou le quitte.

Ce code fait partie d’un exemple plus large disponible dans 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 repeint de cellule dans des conditions qui n’entraînent normalement pas la repeinte d’une cellule. Par exemple, vous pouvez utiliser cette méthode avec un type de cellule personnalisé qui modifie son apparence à la suite d’événements externes.

Pour plus d’informations sur la peinture et l’invalidation, consultez Invalidate.

Voir aussi

• Invalidate
• DataGridView, contrôle (Windows Forms)

InvalidateCell(Int32, Int32)

Invalide la cellule avec les index de ligne et de colonne spécifiés, en la forçant à être redessinée.

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.

rowIndex

Int32

Index de ligne de la cellule à invalider.

Exceptions

ArgumentOutOfRangeException

columnIndex est inférieur à -1 ou supérieur au nombre de colonnes dans le contrôle moins 1.

• ou - rowIndex est inférieur à -1 ou supérieur au nombre de lignes dans le contrôle moins 1.

Exemples

L’exemple de code suivant montre comment utiliser cette méthode dans un type de cellule personnalisé qui modifie l’apparence d’une cellule lorsque l’utilisateur place le pointeur de la souris dessus. Cet exemple fait partie d’un exemple plus large disponible dans 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 repeint de cellule dans des conditions qui n’entraînent normalement pas la repeinte d’une cellule. Par exemple, vous pouvez utiliser cette méthode avec un type de cellule personnalisé qui modifie son apparence à la suite d’événements externes.

Pour plus d’informations sur la peinture et l’invalidation, consultez Invalidate.

Voir aussi

• Invalidate
• DataGridView, contrôle (Windows Forms)