DataGridView.InvalidateCell DataGridView.InvalidateCell DataGridView.InvalidateCell DataGridView.InvalidateCell Method

Definition

Erklärt eine Zelle in der DataGridView für ungültig und erzwingt, dass sie neu gezeichnet wird.Invalidates a cell in the DataGridView, forcing it to be repainted.

Überlädt

InvalidateCell(DataGridViewCell) InvalidateCell(DataGridViewCell) InvalidateCell(DataGridViewCell)

Erklärt die angegebene Zelle der DataGridView für ungültig und erzwingt, dass sie neu gezeichnet wird.Invalidates the specified cell of the DataGridView, forcing it to be repainted.

InvalidateCell(Int32, Int32) InvalidateCell(Int32, Int32) InvalidateCell(Int32, Int32) InvalidateCell(Int32, Int32)

Erklärt die Zelle mit den angegebenen Zeilen- und Spaltenindizes für ungültig und erzwingt, dass sie neu gezeichnet wird.Invalidates the cell with the specified row and column indexes, forcing it to be repainted.

InvalidateCell(DataGridViewCell) InvalidateCell(DataGridViewCell) InvalidateCell(DataGridViewCell)

Erklärt die angegebene Zelle der DataGridView für ungültig und erzwingt, dass sie neu gezeichnet wird.Invalidates the specified cell of the DataGridView, forcing it to be repainted.

public:
 void InvalidateCell(System::Windows::Forms::DataGridViewCell ^ dataGridViewCell);
public void InvalidateCell (System.Windows.Forms.DataGridViewCell dataGridViewCell);
member this.InvalidateCell : System.Windows.Forms.DataGridViewCell -> unit

Parameter

dataGridViewCell
DataGridViewCell DataGridViewCell DataGridViewCell DataGridViewCell

Die für ungültig zu erklärende DataGridViewCell.The DataGridViewCell to invalidate.

Ausnahmen

dataGridViewCell gehört nicht zur DataGridView.dataGridViewCell does not belong to the DataGridView.

dataGridViewCell ist null.dataGridViewCell is null.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie diese Methode in einem angepassten DataGridViewCell verwendet wird, das mit einem benutzerdefinierten Rahmen gezeichnet wird, wenn der Mauszeiger darauf liegt.The following code example illustrates how to use this method in a customized DataGridViewCell that is painted with a custom border when the mouse pointer rests on it. Im Beispiel wird die Zelle für ungültig erklärt, wenn der Mauszeiger in Sie eintritt oder Sie verlässt.In the example, the cell is invalidated when the mouse pointer enters or leaves it.

Dieser Code ist Teil eines größeren Beispiels, das in Gewusst wie: Passen Sie Zellen und Spalten im Windows Forms DataGridView-Steuerelement an, indem Siedas Verhalten und die Darstellung erweitern.This code is part of a larger example available in How to: Customize Cells and Columns in the Windows Forms DataGridView Control by Extending Their Behavior and Appearance.

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

Hinweise

Diese Methode ist nützlich, um das Neuzeichnen einer Zelle in Bedingungen zu erzwingen, die normalerweise bewirken, dass eine Zelle neu gezeichnet wird.This method is useful to force a cell repaint in conditions that would not normally cause a cell to be repainted. Beispielsweise können Sie diese Methode mit einem benutzerdefinierten Zellentyp verwenden, der seine Darstellung als Ergebnis externer Ereignisse ändert.For example, you can use this method with a custom cell type that changes its appearance as a result of external events.

Weitere Informationen zum Zeichnen und Aufheben der Invalidierung finden InvalidateSie unter.For more information about painting and invalidation, see Invalidate.

Siehe auch

InvalidateCell(Int32, Int32) InvalidateCell(Int32, Int32) InvalidateCell(Int32, Int32) InvalidateCell(Int32, Int32)

Erklärt die Zelle mit den angegebenen Zeilen- und Spaltenindizes für ungültig und erzwingt, dass sie neu gezeichnet wird.Invalidates the cell with the specified row and column indexes, forcing it to be repainted.

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

Der Spaltenindex der Zelle, die für ungültig erklärt werden soll.The column index of the cell to invalidate.

rowIndex
Int32 Int32 Int32 Int32

Der Zeilenindex der Zelle, die für ungültig erklärt werden soll.The row index of the cell to invalidate.

Ausnahmen

columnIndex ist kleiner als -1 oder größer als die Anzahl der Spalten im Steuerelement minus 1.columnIndex is less than -1 or greater than the number of columns in the control minus 1.

- oder --or- rowIndex ist kleiner als -1 oder größer als die Anzahl der Zeilen im Steuerelement minus 1.rowIndex is less than -1 or greater than the number of rows in the control minus 1.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie diese Methode in einem benutzerdefinierten Zellentyp verwendet wird, der die Darstellung einer Zelle ändert, wenn der Benutzer mit dem Mauszeiger darüber bewegt wird.The following code example illustrates how to use this method in a custom cell type that changes a cell's appearance when the user rests the mouse pointer over it. Dieses Beispiel ist Teil eines größeren Beispiels, das unter Vorgehensweise: Passen Sie Zellen und Spalten im Windows Forms DataGridView-Steuerelement an, indem Siedas Verhalten und die Darstellung erweitern.This example is part of a larger example available in How to: Customize Cells and Columns in the Windows Forms DataGridView Control by Extending Their Behavior and Appearance.

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

Hinweise

Diese Methode ist nützlich, um das Neuzeichnen einer Zelle in Bedingungen zu erzwingen, die normalerweise bewirken, dass eine Zelle neu gezeichnet wird.This method is useful to force a cell repaint in conditions that would not normally cause a cell to be repainted. Beispielsweise können Sie diese Methode mit einem benutzerdefinierten Zellentyp verwenden, der seine Darstellung als Ergebnis externer Ereignisse ändert.For example, you can use this method with a custom cell type that changes its appearance as a result of external events.

Weitere Informationen zum Zeichnen und Aufheben der Invalidierung finden InvalidateSie unter.For more information about painting and invalidation, see Invalidate.

Siehe auch

Gilt für: