DataGridView.InvalidateCell Methode

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Ungültige Zelle in der DataGridViewZelle, die erzwingt, dass sie aktualisiert wird.

Überlädt

Name Beschreibung
InvalidateCell(DataGridViewCell)

Ungültigt die angegebene Zelle der DataGridView, die erzwungen wird, dass sie aktualisiert wird.
InvalidateCell(Int32, Int32)

Ungültigisiert die Zelle mit den angegebenen Zeilen- und Spaltenindizes, wodurch die Aktualisierung erzwungen wird.

InvalidateCell(DataGridViewCell)

Quelle:
DataGridView.Methods.cs
Quelle:
DataGridView.Methods.cs
Quelle:
DataGridView.Methods.cs
Quelle:
DataGridView.Methods.cs
Quelle:
DataGridView.Methods.cs

Ungültigt die angegebene Zelle der DataGridView, die erzwungen wird, dass sie aktualisiert wird.

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

Der DataGridViewCell ungültige Wert.

Ausnahmen

ArgumentException

dataGridViewCell gehört nicht zum DataGridView.

ArgumentNullException

dataGridViewCell ist null.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie diese Methode in einer angepassten DataGridViewCell Methode verwenden, die mit einem benutzerdefinierten Rahmen gezeichnet wird, wenn der Mauszeiger darauf zeigt. Im Beispiel wird die Zelle ungültig, wenn der Mauszeiger ihn eingibt oder verlässt.

Dieser Code ist Teil eines größeren Beispiels, das 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 eine Zellaktualisierung unter Bedingungen zu erzwingen, die normalerweise nicht dazu führen würden, dass eine Zelle aktualisiert wird. Sie können diese Methode z. B. mit einem benutzerdefinierten Zelltyp verwenden, der seine Darstellung als Ergebnis externer Ereignisse ändert.

Weitere Informationen zum Malen und Zur Ungültigierung finden Sie unter Invalidate.

Weitere Informationen

Gilt für:

InvalidateCell(Int32, Int32)

Quelle:
DataGridView.Methods.cs
Quelle:
DataGridView.Methods.cs
Quelle:
DataGridView.Methods.cs
Quelle:
DataGridView.Methods.cs
Quelle:
DataGridView.Methods.cs

Ungültigisiert die Zelle mit den angegebenen Zeilen- und Spaltenindizes, wodurch die Aktualisierung erzwungen wird.

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

Der Spaltenindex der zu ungültigen Zelle.

rowIndex
Int32

Der Zeilenindex der Zelle, die ungültig werden soll.

Ausnahmen

ArgumentOutOfRangeException

columnIndex ist kleiner als -1 oder größer als die Anzahl der Spalten im Steuerelement minus 1.

-oder-

rowIndex ist kleiner als -1 oder größer als die Anzahl der Zeilen im Steuerelement minus 1.

Beispiele

Das folgende Codebeispiel veranschaulicht die Verwendung dieser Methode in einem benutzerdefinierten Zelltyp, der die Darstellung einer Zelle ändert, wenn der Benutzer den Mauszeiger darauf zeigt. 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 eine Zellaktualisierung unter Bedingungen zu erzwingen, die normalerweise nicht dazu führen würden, dass eine Zelle aktualisiert wird. Sie können diese Methode z. B. mit einem benutzerdefinierten Zelltyp verwenden, der seine Darstellung als Ergebnis externer Ereignisse ändert.

Weitere Informationen zum Malen und Zur Ungültigierung finden Sie unter Invalidate.

Weitere Informationen

Gilt für: