DataGridView.InvalidateCell Methode

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Erklärt eine Zelle in der DataGridView für ungültig und erzwingt, dass sie neu gezeichnet wird.

Überlädt

InvalidateCell(DataGridViewCell)	Erklärt die angegebene Zelle der DataGridView für ungültig und erzwingt, dass sie neu gezeichnet wird.
InvalidateCell(Int32, Int32)	Erklärt die Zelle mit den angegebenen Zeilen- und Spaltenindizes für ungültig und erzwingt, dass sie neu gezeichnet wird.

InvalidateCell(DataGridViewCell)

Erklärt die angegebene Zelle der DataGridView für ungültig und erzwingt, dass sie neu gezeichnet 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

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

Ausnahmen

ArgumentException

dataGridViewCell gehört nicht zur 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 sich der Mauszeiger darauf befindet. Im Beispiel wird die Zelle ungültig, wenn der Mauszeiger 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 Erweitern des Verhaltens und der Darstellung verfügbar ist.

// 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 Zellrepaint unter Bedingungen zu erzwingen, die normalerweise nicht dazu führen würden, dass eine Zelle neu formatiert wird. Sie können diese Methode beispielsweise mit einem benutzerdefinierten Zelltyp verwenden, der die Darstellung als Ergebnis externer Ereignisse ändert.

Weitere Informationen zu Malerei und Ungültigheit finden Sie unter Invalidate.

Siehe auch

• Invalidate
• DataGridView-Steuerelement (Windows Forms)

InvalidateCell(Int32, Int32)

Erklärt die Zelle mit den angegebenen Zeilen- und Spaltenindizes für ungültig und erzwingt, dass sie neu gezeichnet 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 Zelle, die für ungültig erklärt werden soll.

rowIndex

Int32

Der Zeilenindex der Zelle, die für ungültig erklärt 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

Im folgenden Codebeispiel wird veranschaulicht, wie Sie diese Methode in einem benutzerdefinierten Zelltyp verwenden, der die Darstellung einer Zelle ändert, wenn der Benutzer den Mauszeiger darauf zeigt. Dieses Beispiel ist Teil eines größeren Beispiels, das in How to: Customize Cells and Columns in the Windows Forms DataGridView Control by Erweitern des Verhaltens und der Darstellung verfügbar ist.

// 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 Zellrepaint unter Bedingungen zu erzwingen, die normalerweise nicht dazu führen würden, dass eine Zelle neu formatiert wird. Sie können diese Methode beispielsweise mit einem benutzerdefinierten Zelltyp verwenden, der die Darstellung als Ergebnis externer Ereignisse ändert.

Weitere Informationen zu Malerei und Ungültigheit finden Sie unter Invalidate.

Siehe auch

• Invalidate
• DataGridView-Steuerelement (Windows Forms)