DataGridView.InvalidateCell Método

Definição

Invalida uma célula no DataGridView, obrigando-a a ser repintada.

Sobrecargas

Name Description
InvalidateCell(DataGridViewCell)

Invalida a célula especificada do DataGridView, obrigando-a a ser repintada.

InvalidateCell(Int32, Int32)

Invalida a célula com os índices de linha e coluna especificados, forçando a sua nova pintura.

InvalidateCell(DataGridViewCell)

Invalida a célula especificada do DataGridView, obrigando-a a ser repintada.

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

O DataGridViewCell para invalidar.

Exceções

dataGridViewCell não pertence ao DataGridView.

dataGridViewCell é null.

Exemplos

O exemplo de código seguinte ilustra como usar este método num método personalizado DataGridViewCell que é pintado com uma borda personalizada quando o ponteiro do rato repousa sobre ele. No exemplo, a célula é invalidada quando o ponteiro do rato entra ou sai.

Este código faz parte de um exemplo maior disponível em Como: Personalizar células e colunas no controlo Windows Forms DataGridView estendendo o seu comportamento e aparência.

// 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

Observações

Este método é útil para forçar uma repintura de célula em condições que normalmente não causariam a repintura de uma célula. Por exemplo, pode usar este método com um tipo de célula personalizado que altera a sua aparência como resultado de eventos externos.

Para mais informações sobre pintura e invalidação, veja Invalidate.

Ver também

Aplica-se a

InvalidateCell(Int32, Int32)

Invalida a célula com os índices de linha e coluna especificados, forçando a sua nova pintura.

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

O índice da coluna da célula para invalidar.

rowIndex
Int32

O índice de linha da célula para invalidar.

Exceções

columnIndex é menor que -1 ou superior ao número de colunas no controlo menos 1.

-ou-

rowIndex é menor que -1 ou superior ao número de linhas no controlo menos 1.

Exemplos

O exemplo de código seguinte ilustra como usar este método num tipo de célula personalizado que altera a aparência de uma célula quando o utilizador coloca o ponteiro do rato sobre ela. Este exemplo faz parte de um exemplo maior disponível em Como: Personalizar células e colunas no controlo Windows Forms DataGridView estendendo o seu comportamento e aparência.

// 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

Observações

Este método é útil para forçar uma repintura de célula em condições que normalmente não causariam a repintura de uma célula. Por exemplo, pode usar este método com um tipo de célula personalizado que altera a sua aparência como resultado de eventos externos.

Para mais informações sobre pintura e invalidação, veja Invalidate.

Ver também

Aplica-se a