DataGridView.InvalidateCell Metodo

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Invalida una cella in DataGridView, forzandone il ridisegno.

Overload

InvalidateCell(DataGridViewCell)	Invalida la cella specificata di DataGridView, forzandone il ridisegno.
InvalidateCell(Int32, Int32)	Invalida la cella con gli indici di riga e di colonna specificati, imponendo che la cella venga ridisegnata.

InvalidateCell(DataGridViewCell)

Origine:

DataGridView.Methods.cs

Invalida la cella specificata di DataGridView, forzandone il ridisegno.

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)

Parametri

dataGridViewCell

DataGridViewCell

Oggetto DataGridViewCell da invalidare.

Eccezioni

ArgumentException

dataGridViewCell non appartiene a DataGridView.

ArgumentNullException

dataGridViewCell è null.

Esempio

Nell'esempio di codice seguente viene illustrato come usare questo metodo in un oggetto personalizzato dipinto DataGridViewCell con un bordo personalizzato quando il puntatore del mouse si riposa su di esso. Nell'esempio la cella viene invalidata quando il puntatore del mouse entra o lo lascia.

Questo codice fa parte di un esempio più ampio disponibile in Procedura: Personalizzare celle e colonne nel controllo DataGridView Windows Forms estendendo il comportamento e l'aspetto.

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

Commenti

Questo metodo è utile per forzare il repaint di una cella in condizioni che normalmente non causano il ripainting di una cella. Ad esempio, è possibile usare questo metodo con un tipo di cella personalizzato che modifica l'aspetto come risultato di eventi esterni.

Per altre informazioni sulla pittura e sull'invalidazione, vedere Invalidate.

Vedi anche

• Invalidate
• Controllo DataGridView (Windows Form)

InvalidateCell(Int32, Int32)

Origine:

DataGridView.Methods.cs

Invalida la cella con gli indici di riga e di colonna specificati, imponendo che la cella venga ridisegnata.

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)

Parametri

columnIndex

Int32

Indice di colonna della cella da invalidare.

rowIndex

Int32

Indice di riga della cella da invalidare.

Eccezioni

ArgumentOutOfRangeException

columnIndex è minore di -1 o maggiore del numero di colonne nel controllo meno 1.

-oppure-

rowIndex è minore di -1 o maggiore del numero di righe nel controllo meno 1.

Esempio

Nell'esempio di codice seguente viene illustrato come usare questo metodo in un tipo di cella personalizzato che modifica l'aspetto di una cella quando l'utente riposa il puntatore del mouse su di esso. Questo esempio fa parte di un esempio più ampio disponibile in Procedura: Personalizzare celle e colonne nel controllo DataGridView Windows Forms estendendone il comportamento e l'aspetto.

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

Commenti

Questo metodo è utile per forzare il repaint di una cella in condizioni che normalmente non causano il ripainting di una cella. Ad esempio, è possibile usare questo metodo con un tipo di cella personalizzato che modifica l'aspetto come risultato di eventi esterni.

Per altre informazioni sulla pittura e sull'invalidazione, vedere Invalidate.

Vedi anche

• Invalidate
• Controllo DataGridView (Windows Form)