DataGridView.InvalidateCell Yöntem

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

içindeki bir hücreyi DataGridViewgeçersiz kılır ve yeniden boyanmaya zorlar.

Aşırı Yüklemeler

InvalidateCell(DataGridViewCell)	belirtilen hücresini DataGridViewgeçersiz kılır ve yeniden boyanmaya zorlar.
InvalidateCell(Int32, Int32)	Belirtilen satır ve sütun dizinlerine sahip hücreyi geçersiz kılıp yeniden boyanmaya zorlar.

InvalidateCell(DataGridViewCell)

belirtilen hücresini DataGridViewgeçersiz kılır ve yeniden boyanmaya zorlar.

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)

Parametreler

dataGridViewCell

DataGridViewCell

DataGridViewCell geçersiz kılınacak.

Özel durumlar

ArgumentException

dataGridViewCell öğesine ait DataGridViewdeğildir.

ArgumentNullException

dataGridViewCell, null değeridir.

Örnekler

Aşağıdaki kod örneği, fare işaretçisi üzerine geldiğinde özel kenarlıkla boyanmış özelleştirilmiş DataGridViewCell bir yöntemde bu yöntemin nasıl kullanılacağını gösterir. Örnekte, fare işaretçisi hücreyi girdiğinde veya bıraktığında hücre geçersiz kılınıyor.

Bu kod, How to: Customize Cells and Columns in the Windows Forms DataGridView Control by Extending The Behavior and Appearance bölümünde bulunan daha büyük bir örneğin parçasıdır.

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

Açıklamalar

Bu yöntem, normalde hücrenin yeniden boyanmasına neden olmayacak koşullarda hücrenin yeniden boyanmasına zorlamak için yararlıdır. Örneğin, dış olaylar sonucunda görünümünü değiştiren özel bir hücre türüyle bu yöntemi kullanabilirsiniz.

Boyama ve geçersizleştirme hakkında daha fazla bilgi için bkz Invalidate. .

Ayrıca bkz.

• Invalidate
• DataGridView Denetimi (Windows Forms)

InvalidateCell(Int32, Int32)

Belirtilen satır ve sütun dizinlerine sahip hücreyi geçersiz kılıp yeniden boyanmaya zorlar.

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)

Parametreler

columnIndex

Int32

Geçersiz kılınacak hücrenin sütun dizini.

rowIndex

Int32

Geçersiz kılınacak hücrenin satır dizini.

Özel durumlar

ArgumentOutOfRangeException

columnIndex -1'den küçük veya denetimdeki sütun sayısından eksi 1'den büyük.

-veya- rowIndex -1'den küçük veya denetimdeki satır sayısı eksi 1'den büyük.

Örnekler

Aşağıdaki kod örneği, kullanıcı fare işaretçisini üzerine getirince hücrenin görünümünü değiştiren özel bir hücre türünde bu yöntemin nasıl kullanılacağını göstermektedir. Bu örnek, Nasıl yapılır: Davranış ve Görünümlerini Genişleterek Windows Forms DataGridView Denetimindeki Hücreleri ve Sütunları Özelleştirme bölümünde bulunan daha büyük bir örneğin bir parçasıdır.

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

Açıklamalar

Bu yöntem, normalde hücrenin yeniden boyanmasına neden olmayacak koşullarda hücrenin yeniden boyanmasına zorlamak için yararlıdır. Örneğin, dış olaylar sonucunda görünümünü değiştiren özel bir hücre türüyle bu yöntemi kullanabilirsiniz.

Boyama ve geçersizleştirme hakkında daha fazla bilgi için bkz Invalidate. .

Ayrıca bkz.

• Invalidate
• DataGridView Denetimi (Windows Forms)