Freigeben über


DataGridView.ClearSelection Methode

Definition

Hebt die Auswahl der gerade ausgewählten Zellen auf.

Überlädt

ClearSelection(Int32, Int32, Boolean)

Hebt die aktuelle Auswahl aller ausgewählten Zellen mit Ausnahme der angegebenen auf und stellt optional sicher, dass die angegebene Zelle ausgewählt ist.

ClearSelection()

Löscht die aktuelle Auswahl durch Aufheben der Auswahl aller ausgewählten Zellen.

ClearSelection(Int32, Int32, Boolean)

Hebt die aktuelle Auswahl aller ausgewählten Zellen mit Ausnahme der angegebenen auf und stellt optional sicher, dass die angegebene Zelle ausgewählt ist.

protected:
 void ClearSelection(int columnIndexException, int rowIndexException, bool selectExceptionElement);
protected void ClearSelection (int columnIndexException, int rowIndexException, bool selectExceptionElement);
member this.ClearSelection : int * int * bool -> unit
Protected Sub ClearSelection (columnIndexException As Integer, rowIndexException As Integer, selectExceptionElement As Boolean)

Parameter

columnIndexException
Int32

Der auszuschließende Spaltenindex.

rowIndexException
Int32

Der auszuschließende Zeilenindex.

selectExceptionElement
Boolean

true, um die ausgeschlossene Zelle, Zeile oder Spalte auszuwählen, false, um ihren ursprünglichen Zustand zu beizubehalten.

Ausnahmen

columnIndexException ist größer als der höchste Spaltenindex.

- oder -

columnIndexException ist kleiner als-1, wenn SelectionMode gleich FullRowSelect ist; andernfalls ist columnIndexException kleiner als 0.

- oder -

rowIndexException ist größer als der höchste Zeilenindex.

- oder -

rowIndexException ist kleiner als-1, wenn SelectionMode gleich FullColumnSelect ist; andernfalls ist rowIndexException kleiner als 0.

Hinweise

Der rowIndexException Wert -1 stellt eine Spaltenüberschrift und der columnIndexException Wert -1 einen Zeilenheader dar.

Diese Methode ist nützlich, um die aktuelle Auswahl zu löschen, ohne die Auswahl der Zelle, Zeile oder Spalte, die durch die Ausnahmeindizes angegeben wird, abzubrechen.

Wenn der -Eigenschaftswert die SelectionMode Auswahl einzelner Zellen zulässt, legt diese Methode die Selected Eigenschaft jeder Zelle auf fest false, wobei die Zelle in der angegebenen Zeile und Spalte ausgeschlossen wird. Wenn der -Eigenschaftswert die SelectionMode vollständige Zeilen- oder Spaltenauswahl zulässt, legt diese Methode auch die Selected Eigenschaft jeder Zeile oder Spalte auf fest false, wobei die Zeile oder Spalte, die die angegebene Zelle enthält, auf festgelegt wird.

Die ausgeschlossene Zelle, Zeile oder Spalte kann sich im ausgewählten Zustand befinden, wenn diese Methode aufgerufen wird. Diese Methode wählt sie aus, wenn der selectExceptionElement Parameterwert ist true. Je nach Auswahlmodus kann als Ergebnis auch die gesamte Zeile oder Spalte ausgewählt werden.

Weitere Informationen

Gilt für:

ClearSelection()

Löscht die aktuelle Auswahl durch Aufheben der Auswahl aller ausgewählten Zellen.

public:
 void ClearSelection();
public void ClearSelection ();
member this.ClearSelection : unit -> unit
Public Sub ClearSelection ()

Beispiele

Im folgenden Codebeispiel wird die Auswahl von DataGridViewgelöscht. Fügen Sie zum Ausführen dieses Beispiels den Code in ein Formular ein, das einen DataGridView benannten dataGridView1 und einen Button namens clearSelectionButtonenthält, und stellen Sie sicher, dass alle Ereignisse ihren Ereignishandlern zugeordnet sind.

private void clearSelectionButton_Click(object sender, EventArgs e)
{
    dataGridView1.ClearSelection();
}
Private Sub clearSelectionButton_Click(ByVal sender As Object, _
    ByVal e As EventArgs) Handles clearSelectionButton.Click

    dataGridView1.ClearSelection()

End Sub

Hinweise

Wenn diese Methode aufgerufen wird, wird die Eigenschaft jeder Spalte und Zeile Selected auf falsefestgelegt.

Weitere Informationen

Gilt für: