DataGridView.InvalidateCell Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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.