DataGridView.InvalidateCell Método

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Invalida una celda del control DataGridView y obliga a que se vuelva a dibujar.

Sobrecargas

InvalidateCell(DataGridViewCell)	Invalida la celda especificada del control DataGridView y obliga a que se vuelva a dibujar.
InvalidateCell(Int32, Int32)	Invalida la celda con los índices de fila y columna especificados, forzándola a que se vuelva a dibujar.

InvalidateCell(DataGridViewCell)

Invalida la celda especificada del control DataGridView y obliga a que se vuelva a dibujar.

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)

Parámetros

dataGridViewCell

DataGridViewCell

DataGridViewCell que se va a invalidar.

Excepciones

ArgumentException

dataGridViewCell no pertenece a la DataGridView.

ArgumentNullException

dataGridViewCell es null.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar este método en un personalizado DataGridViewCell que se pinta con un borde personalizado cuando el puntero del mouse se encuentra en él. En el ejemplo, la celda se invalida cuando el puntero del mouse entra o lo deja.

Este código forma parte de un ejemplo más grande disponible en How to: Customize Cells and Columns in the Windows Forms DataGridView Control by Extend 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

Comentarios

Este método es útil para forzar un reintentos de celda en condiciones que normalmente no harían que una celda se vuelva a pintar. Por ejemplo, puede usar este método con un tipo de celda personalizado que cambie su apariencia como resultado de eventos externos.

Para obtener más información sobre la pintura y la invalidación, vea Invalidate.

Consulte también

• Invalidate
• DataGridView (Control, formularios Windows Forms)

InvalidateCell(Int32, Int32)

Invalida la celda con los índices de fila y columna especificados, forzándola a que se vuelva a dibujar.

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)

Parámetros

columnIndex

Int32

Índice de columna de la celda que se desea invalidar.

rowIndex

Int32

Índice de fila de la celda que se va a invalidar.

Excepciones

ArgumentOutOfRangeException

columnIndex es menor que -1 o mayor que el número de columnas del control menos 1.

o bien rowIndex es menor que -1 o mayor que el número de filas del control menos 1.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar este método en un tipo de celda personalizado que cambia la apariencia de una celda cuando el usuario descansa el puntero del mouse sobre él. Este ejemplo forma parte de un ejemplo más grande disponible en How to: Customize Cells and Columns in the Windows Forms DataGridView Control by Extend 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

Comentarios

Este método es útil para forzar un reintentos de celda en condiciones que normalmente no harían que una celda se vuelva a pintar. Por ejemplo, puede usar este método con un tipo de celda personalizado que cambie su apariencia como resultado de eventos externos.

Para obtener más información sobre la pintura y la invalidación, vea Invalidate.

Consulte también

• Invalidate
• DataGridView (Control, formularios Windows Forms)