DataGridView.InvalidateCell Método

Definición

Invalida una celda del control DataGridView y obliga a que se vuelva a dibujar.Invalidates a cell in the DataGridView, forcing it to be repainted.

Sobrecargas

InvalidateCell(DataGridViewCell)

Invalida la celda especificada del control DataGridView y obliga a que se vuelva a dibujar.Invalidates the specified cell of the DataGridView, forcing it to be repainted.

InvalidateCell(Int32, Int32)

Invalida la celda con los índices de fila y columna especificados, forzándola a que se vuelva a dibujar.Invalidates the cell with the specified row and column indexes, forcing it to be repainted.

InvalidateCell(DataGridViewCell)

Invalida la celda especificada del control DataGridView y obliga a que se vuelva a dibujar.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

Parámetros

dataGridViewCell
DataGridViewCell

DataGridViewCell que se va a invalidar.The DataGridViewCell to invalidate.

Excepciones

dataGridViewCell no pertenece a la DataGridView.dataGridViewCell does not belong to the DataGridView.

dataGridViewCell es null.dataGridViewCell is null.

Ejemplos

En el ejemplo de código siguiente se muestra cómo utilizar este método en un @no__t personalizado-0 que se pinta con un borde personalizado cuando el puntero del mouse se sitúa sobre él.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. En el ejemplo, se invalida la celda cuando el puntero del Mouse entra o sale de ella.In the example, the cell is invalidated when the mouse pointer enters or leaves it.

Este código forma parte de un ejemplo más grande disponible en [How para: Personalice las celdas y columnas en el control DataGridView Windows Forms extendiendo su comportamiento y apariencia @ no__t-0.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

Comentarios

Este método es útil para forzar que una celda vuelva a dibujarse en condiciones que normalmente no harían que se vuelva a dibujar una celda.This method is useful to force a cell repaint in conditions that would not normally cause a cell to be repainted. Por ejemplo, puede usar este método con un tipo de celda personalizado que cambie su apariencia como resultado de eventos externos.For example, you can use this method with a custom cell type that changes its appearance as a result of external events.

Para obtener más información sobre cómo pintar e invalidar, vea Invalidate.For more information about painting and invalidation, see Invalidate.

Consulte también:

InvalidateCell(Int32, Int32)

Invalida la celda con los índices de fila y columna especificados, forzándola a que se vuelva a dibujar.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)

Parámetros

columnIndex
Int32

Índice de columna de la celda que se desea invalidar.The column index of the cell to invalidate.

rowIndex
Int32

Índice de fila de la celda que se va a invalidar.The row index of the cell to invalidate.

Excepciones

columnIndex es menor que -1 o mayor que el número de columnas del control menos 1.columnIndex is less than -1 or greater than the number of columns in the control minus 1.

o bien-or- rowIndex es menor que -1 o mayor que el número de filas del control menos 1.rowIndex is less than -1 or greater than the number of rows in the control minus 1.

Ejemplos

En el ejemplo de código siguiente se muestra cómo utilizar este método en un tipo de celda personalizado que cambia la apariencia de una celda cuando el usuario coloca el puntero del mouse sobre él.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. Este ejemplo forma parte de un ejemplo más grande disponible en [How para: Personalice las celdas y columnas en el control DataGridView Windows Forms extendiendo su comportamiento y apariencia @ no__t-0.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

Comentarios

Este método es útil para forzar que una celda vuelva a dibujarse en condiciones que normalmente no harían que se vuelva a dibujar una celda.This method is useful to force a cell repaint in conditions that would not normally cause a cell to be repainted. Por ejemplo, puede usar este método con un tipo de celda personalizado que cambie su apariencia como resultado de eventos externos.For example, you can use this method with a custom cell type that changes its appearance as a result of external events.

Para obtener más información sobre cómo pintar e invalidar, vea Invalidate.For more information about painting and invalidation, see Invalidate.

Consulte también:

Se aplica a