DataGridView.InvalidateCell Metoda

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Unieważnia komórkę w DataGridViewobiekcie , zmuszając ją do przemalowania.

Przeciążenia

InvalidateCell(DataGridViewCell)	Unieważnia określoną komórkę DataGridViewobiektu , wymuszając jej przemalowanie.
InvalidateCell(Int32, Int32)	Unieważnia komórkę z określonymi indeksami wierszy i kolumn, zmuszając ją do przemalowania.

InvalidateCell(DataGridViewCell)

Unieważnia określoną komórkę DataGridViewobiektu , wymuszając jej przemalowanie.

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)

Parametry

dataGridViewCell

DataGridViewCell

Element do unieważnienia DataGridViewCell .

Wyjątki

ArgumentException

dataGridViewCellnie należy do .DataGridView

ArgumentNullException

dataGridViewCell to null.

Przykłady

W poniższym przykładzie kodu pokazano, jak używać tej metody w dostosowanym obrazie DataGridViewCell z niestandardowym obramowaniem, gdy wskaźnik myszy spoczywa na niej. W tym przykładzie komórka jest unieważniona po wprowadzeniu lub opuszczeniu wskaźnika myszy.

Ten kod jest częścią większego przykładu dostępnego w temacie How to: Customize Cells and Columns in the Windows Forms DataGridView Control (Dostosowywanie komórek i kolumn w kontrolce DataGridView) przez rozszerzenie ich zachowania i wyglądu.

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

Uwagi

Ta metoda jest przydatna do wymuszenia ponownego przemalowania komórki w warunkach, które normalnie nie spowodują ponownego przemalowania komórki. Można na przykład użyć tej metody z niestandardowym typem komórki, który zmienia jego wygląd w wyniku zdarzeń zewnętrznych.

Aby uzyskać więcej informacji na temat malowania i unieważniania, zobacz Invalidate.

Zobacz też

• Invalidate
• DataGridView — Formant (Formularze systemu Windows)

InvalidateCell(Int32, Int32)

Unieważnia komórkę z określonymi indeksami wierszy i kolumn, zmuszając ją do przemalowania.

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)

Parametry

columnIndex

Int32

Indeks kolumny komórki do unieważnienia.

rowIndex

Int32

Indeks wiersza komórki do unieważnienia.

Wyjątki

ArgumentOutOfRangeException

columnIndex wartość jest mniejsza niż -1 lub większa niż liczba kolumn w kontrolce minus 1.

-lub- rowIndex wartość jest mniejsza niż -1 lub większa niż liczba wierszy w kontrolce minus 1.

Przykłady

Poniższy przykład kodu ilustruje sposób użycia tej metody w niestandardowym typie komórki, który zmienia wygląd komórki, gdy użytkownik spoczywa na niej wskaźnik myszy. Ten przykład jest częścią większego przykładu dostępnego w temacie How to: Customize Cells and Columns in the Windows Forms DataGridView Control (Dostosowywanie komórek i kolumn w kontrolce DataGridView) przez rozszerzenie ich zachowania i wyglądu.

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

Uwagi

Ta metoda jest przydatna do wymuszenia ponownego przemalowania komórki w warunkach, które normalnie nie spowodują ponownego przemalowania komórki. Można na przykład użyć tej metody z niestandardowym typem komórki, który zmienia jego wygląd w wyniku zdarzeń zewnętrznych.

Aby uzyskać więcej informacji na temat malowania i unieważniania, zobacz Invalidate.

Zobacz też

• Invalidate
• DataGridView — Formant (Formularze systemu Windows)