DataGridView.InvalidateCell 方法

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

使 DataGridView 中的儲存格失效，以強制重新繪製該儲存格。

多載

InvalidateCell(DataGridViewCell)	使 DataGridView 的指定儲存格失效，以強制重新繪製該儲存格。
InvalidateCell(Int32, Int32)	讓具有指定資料列和資料行索引的儲存格失效，強制重新繪製它。

InvalidateCell(DataGridViewCell)

使 DataGridView 的指定儲存格失效，以強制重新繪製該儲存格。

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)

參數

dataGridViewCell

DataGridViewCell

要使其失效的 DataGridViewCell。

例外狀況

ArgumentException

dataGridViewCell 不屬於 DataGridView。

ArgumentNullException

dataGridViewCell 為 null。

範例

下列程式碼範例說明如何在自訂的自訂 DataGridViewCell 中使用這個方法，當滑鼠指標停留在自訂框線上時， 會以自訂框線繪製。 在此範例中，當滑鼠指標進入或離開儲存格時，儲存格會失效。

此程式碼是如何：藉由擴充其行為和外觀，在 Windows Forms DataGridView 控制項中自訂儲存格和資料行的一部分。

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

備註

這個方法有助於強制儲存格重繪在通常不會重新繪製儲存格的狀況中。 例如，您可以將這個方法與自訂資料格類型搭配使用，而此類型會因為外來事件而變更其外觀。

如需繪製和失效的詳細資訊，請參閱 Invalidate 。

另請參閱

• Invalidate
• DataGridView 控制項 (Windows Form)

InvalidateCell(Int32, Int32)

讓具有指定資料列和資料行索引的儲存格失效，強制重新繪製它。

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)

參數

columnIndex

Int32

失效的儲存格之資料行索引。

rowIndex

Int32

要使其失效之儲存格的資料列索引。

例外狀況

ArgumentOutOfRangeException

columnIndex 小於 -1，或大於控制項中的資料行數目減 1。

-或- rowIndex 小於 -1，或大於控制項中的資料列數目減 1。

範例

下列程式碼範例說明如何在自訂儲存格類型中使用這個方法，以在使用者將滑鼠指標放在該儲存格上方時變更儲存格的外觀。 此範例是如何：擴充其行為和外觀，以自訂 dataGridView 控制項中Windows Forms儲存格和資料行中較大型範例的一部分。

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

備註

這個方法有助於強制儲存格重繪在通常不會重新繪製儲存格的狀況中。 例如，您可以將這個方法與自訂資料格類型搭配使用，而此類型會因為外來事件而變更其外觀。

如需繪製和失效的詳細資訊，請參閱 Invalidate 。

另請參閱

• Invalidate
• DataGridView 控制項 (Windows Form)