DataGridView.InvalidateCell Método

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Invalida uma célula no DataGridView, forçando-a a ser pintada novamente.

Sobrecargas

InvalidateCell(DataGridViewCell)	Invalida a célula especificada do DataGridView, forçando-a a ser pintada novamente.
InvalidateCell(Int32, Int32)	Invalida a célula com os índices de linha e de coluna especificados, forçando-a a ser pintada novamente.

InvalidateCell(DataGridViewCell)

Invalida a célula especificada do DataGridView, forçando-a a ser pintada novamente.

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 a ser invalidado.

Exceções

ArgumentException

dataGridViewCell não pertence a DataGridView.

ArgumentNullException

dataGridViewCell é null.

Exemplos

O exemplo de código a seguir ilustra como usar esse método em um personalizado DataGridViewCell que é pintado com uma borda personalizada quando o ponteiro do mouse se baseia nele. No exemplo, a célula é invalidada quando o ponteiro do mouse entra ou sai dela.

Esse código faz parte de um exemplo maior disponível em 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

Comentários

Esse método é útil para forçar uma repintização de célula em condições que normalmente não fariam com que uma célula fosse repintada. Por exemplo, você pode usar esse método com um tipo de célula personalizado que altera sua aparência como resultado de eventos externos.

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

Confira também

• Invalidate
• Controle DataGridView (Windows Forms)

InvalidateCell(Int32, Int32)

Invalida a célula com os índices de linha e de coluna especificados, forçando-a a ser pintada novamente.

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 a ser invalidada.

rowIndex

Int32

O índice da linha da célula a ser invalidada.

Exceções

ArgumentOutOfRangeException

columnIndex é menor que -1 ou maior que o número de colunas no controle menos 1.

- ou - rowIndex é menor que -1 ou maior que o número de linhas no controle menos 1.

Exemplos

O exemplo de código a seguir ilustra como usar esse método em um tipo de célula personalizado que altera a aparência de uma célula quando o usuário descansa o ponteiro do mouse sobre ele. Este exemplo faz parte de um exemplo maior disponível em 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

Comentários

Esse método é útil para forçar uma repintização de célula em condições que normalmente não fariam com que uma célula fosse repintada. Por exemplo, você pode usar esse método com um tipo de célula personalizado que altera sua aparência como resultado de eventos externos.

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

Confira também

• Invalidate
• Controle DataGridView (Windows Forms)