DataGridView.InvalidateCell Metode

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Membatalkan validasi sel di DataGridView, memaksanya untuk dicat ulang.

Overload

Nama	Deskripsi
InvalidateCell(DataGridViewCell)	Membatalkan sel yang ditentukan dari DataGridView, memaksanya untuk dicat ulang.
InvalidateCell(Int32, Int32)	Membatalkan sel dengan indeks baris dan kolom yang ditentukan, memaksanya untuk dicat ulang.

InvalidateCell(DataGridViewCell)

Sumber:

DataGridView.Methods.cs

Membatalkan sel yang ditentukan dari DataGridView, memaksanya untuk dicat ulang.

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)

Parameter

dataGridViewCell

DataGridViewCell

untuk DataGridViewCell membatalkan validasi.

Pengecualian

ArgumentException

dataGridViewCell bukan milik DataGridView.

ArgumentNullException

dataGridViewCell adalah null.

Contoh

Contoh kode berikut mengilustrasikan cara menggunakan metode ini dalam yang dikustomisasi DataGridViewCell yang dicat dengan batas kustom saat penunjuk mouse berada di atasnya. Dalam contoh, sel tidak valid saat penunjuk mouse masuk atau meninggalkannya.

Kode ini adalah bagian dari contoh yang lebih besar yang tersedia di Bagaimana cara: Menyesuaikan Sel dan Kolom dalam Formulir Windows Kontrol DataGridView dengan Memperluas Perilaku dan Tampilannya.

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

Keterangan

Metode ini berguna untuk memaksa pengecatan ulang sel dalam kondisi yang biasanya tidak akan menyebabkan sel dicat ulang. Misalnya, Anda dapat menggunakan metode ini dengan tipe sel kustom yang mengubah tampilannya sebagai akibat dari peristiwa eksternal.

Untuk informasi selengkapnya tentang pengecatan dan pembatalan, lihat Invalidate.

Lihat juga

• Invalidate
• Kontrol DataGridView (Formulir Windows)

InvalidateCell(Int32, Int32)

Sumber:

DataGridView.Methods.cs

Membatalkan sel dengan indeks baris dan kolom yang ditentukan, memaksanya untuk dicat ulang.

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)

Parameter

columnIndex

Int32

Indeks kolom sel yang akan divalidasi.

rowIndex

Int32

Indeks baris sel yang akan divalidasi.

Pengecualian

ArgumentOutOfRangeException

columnIndex kurang dari -1 atau lebih besar dari jumlah kolom dalam kontrol minus 1.

-atau-

rowIndex kurang dari -1 atau lebih besar dari jumlah baris dalam kontrol minus 1.

Contoh

Contoh kode berikut mengilustrasikan cara menggunakan metode ini dalam tipe sel kustom yang mengubah tampilan sel saat pengguna mengarahkan penunjuk mouse ke atasnya. Contoh ini adalah bagian dari contoh yang lebih besar yang tersedia di Bagaimana cara: Menyesuaikan Sel dan Kolom dalam Kontrol DataGridView Formulir Windows dengan Memperluas Perilaku dan Tampilannya.

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

Keterangan

Metode ini berguna untuk memaksa pengecatan ulang sel dalam kondisi yang biasanya tidak akan menyebabkan sel dicat ulang. Misalnya, Anda dapat menggunakan metode ini dengan tipe sel kustom yang mengubah tampilannya sebagai akibat dari peristiwa eksternal.

Untuk informasi selengkapnya tentang pengecatan dan pembatalan, lihat Invalidate.

Lihat juga

• Invalidate
• Kontrol DataGridView (Formulir Windows)