DataGridView.InvalidateCell Metoda

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zruší platnost buňky v buňce DataGridViewa vynutí ji, aby se překreslila.

Přetížení

InvalidateCell(DataGridViewCell)	Zneplatní zadanou buňku DataGridViewvynucující jeho překreslení.
InvalidateCell(Int32, Int32)	Zruší platnost buňky se zadanými indexy řádků a sloupců a vynutí ho překreslit.

InvalidateCell(DataGridViewCell)

Zneplatní zadanou buňku DataGridViewvynucující jeho překreslení.

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

Platnost DataGridViewCell je neplatná.

Výjimky

ArgumentException

dataGridViewCellnepatří do .DataGridView

ArgumentNullException

dataGridViewCell je null.

Příklady

Následující příklad kódu ukazuje, jak tuto metodu použít v přizpůsobeném DataGridViewCell , který je namalován vlastním ohraničení, když na něj ukazatel myši přepíná. V příkladu se buňka zneplatní, když ukazatel myši zadá nebo ho opustí.

Tento kód je součástí většího příkladu, který je k dispozici v části Postupy: Přizpůsobení buněk a sloupců v ovládacím prvku model Windows Forms DataGridView rozšířením jejich chování a vzhledu.

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

Poznámky

Tato metoda je užitečná k vynucení překreslení buňky v podmínkách, které by normálně nezpůsobily překreslení buňky. Tuto metodu můžete použít například s vlastním typem buňky, který změní jeho vzhled v důsledku externích událostí.

Další informace o malování a zneplatnění naleznete v tématu Invalidate.

Viz také

• Invalidate
• DataGridView – ovládací prvek (Windows Forms)

InvalidateCell(Int32, Int32)

Zruší platnost buňky se zadanými indexy řádků a sloupců a vynutí ho překreslit.

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

Index sloupce buňky, který se má zrušit.

rowIndex

Int32

Index řádku buňky, který se má zrušit.

Výjimky

ArgumentOutOfRangeException

columnIndex je menší než -1 nebo větší než počet sloupců v ovládacím prvku minus 1.

-nebo- rowIndex je menší než -1 nebo větší než počet řádků v ovládacím prvku minus 1.

Příklady

Následující příklad kódu ukazuje, jak tuto metodu použít ve vlastním typu buňky, která změní vzhled buňky, když uživatel umístí ukazatel myši na něj. Tento příklad je součástí většího příkladu, který je k dispozici v části Postupy: Přizpůsobení buněk a sloupců v ovládacím prvku model Windows Forms DataGridView rozšířením jejich chování a vzhledu.

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

Poznámky

Tato metoda je užitečná k vynucení překreslení buňky v podmínkách, které by normálně nezpůsobily překreslení buňky. Tuto metodu můžete použít například s vlastním typem buňky, který změní jeho vzhled v důsledku externích událostí.

Další informace o malování a zneplatnění naleznete v tématu Invalidate.

Viz také

• Invalidate
• DataGridView – ovládací prvek (Windows Forms)