DataGridView.ClearSelection DataGridView.ClearSelection DataGridView.ClearSelection DataGridView.ClearSelection Method

Definition

Hebt die Auswahl der gerade ausgewählten Zellen auf.Cancels the selection of currently selected cells.

Überlädt

ClearSelection(Int32, Int32, Boolean) ClearSelection(Int32, Int32, Boolean) ClearSelection(Int32, Int32, Boolean) 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.Cancels the selection of all currently selected cells except the one indicated, optionally ensuring that the indicated cell is selected.

ClearSelection() ClearSelection() ClearSelection() ClearSelection()

Löscht die aktuelle Auswahl durch Aufheben der Auswahl aller ausgewählten Zellen.Clears the current selection by unselecting all selected cells.

ClearSelection(Int32, Int32, Boolean) ClearSelection(Int32, Int32, Boolean) ClearSelection(Int32, Int32, Boolean) 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.Cancels the selection of all currently selected cells except the one indicated, optionally ensuring that the indicated cell is selected.

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

Der auszuschließende Spaltenindex.The column index to exclude.

rowIndexException
Int32 Int32 Int32 Int32

Der auszuschließende Zeilenindex.The row index to exclude.

selectExceptionElement
Boolean Boolean Boolean Boolean

true, um die ausgeschlossene Zelle, Zeile oder Spalte auszuwählen, false, um ihren ursprünglichen Zustand zu beizubehalten.true to select the excluded cell, row, or column; false to retain its original state.

Ausnahmen

columnIndexException ist größer als der höchste Spaltenindex.columnIndexException is greater than the highest column index.

- oder --or- columnIndexException ist kleiner als-1, wenn SelectionMode gleich FullRowSelectist; andernfalls ist columnIndexException kleiner als 0.columnIndexException is less than -1 when SelectionMode is FullRowSelect; otherwise, columnIndexException is less than 0.

- oder --or- rowIndexException ist größer als der höchste Zeilenindex.rowIndexException is greater than the highest row index.

- oder --or- rowIndexException ist kleiner als-1, wenn SelectionMode gleich FullColumnSelect ist; andernfalls ist rowIndexException kleiner als 0.rowIndexException is less than -1 when SelectionMode is FullColumnSelect; otherwise, rowIndexException is less than 0.

Hinweise

Der Wert-1 stellt einen Spaltenheader dar, columnIndexException und der Wert-1 stellt einen Zeilen Header dar. rowIndexExceptionA rowIndexException value of -1 represents a column header, and a columnIndexException value of -1 represents a row header.

Diese Methode ist hilfreich, um die aktuelle Auswahl zu löschen, ohne die Auswahl der Zelle, Zeile oder Spalte abzukündigen, die durch die Ausnahme Indizes angegeben wird.This method is useful to clear the current selection without canceling the selection of the cell, row, or column indicated by the exception indexes.

Wenn der SelectionMode Eigenschafts Wert einzelne Zellen Auswahl zulässt, legt diese Methode Selected die-Eigenschaft jeder Zelle falseauf fest, wobei die Zelle in der angegebenen Zeile und Spalte ausgenommen ist.If the SelectionMode property value allows individual cell selection, this method sets the Selected property of each cell to false, excluding the cell in the row and column specified. Wenn der SelectionMode -Eigenschafts Wert die vollständige Zeilen-oder Spaltenauswahl zulässt, Selected legt diese Methode auch die-Eigenschaft falsefür jede Zeile oder Spalte auf fest, wobei die Zeile oder die Spalte mit der angegebenen Zelle ausgeschlossen wird.If the SelectionMode property value allows full row or column selection, this method also sets the Selected property of each row or column to false, excluding the row or column containing the specified cell.

Die ausgeschlossene Zelle, Zeile oder Spalte ist möglicherweise im ausgewählten Zustand, wenn diese Methode aufgerufen wird.The excluded cell, row, or column may or may not be in the selected state when this method is called. Diese Methode wählt Sie aus, selectExceptionElement wenn der Parameter trueWert ist.This method selects it if the selectExceptionElement parameter value is true. Abhängig vom Auswahlmodus kann die gesamte Zeile oder Spalte auch als Ergebnis ausgewählt werden.Depending on the selection mode, the entire row or column may also be selected as a result.

Siehe auch

ClearSelection() ClearSelection() ClearSelection() ClearSelection()

Löscht die aktuelle Auswahl durch Aufheben der Auswahl aller ausgewählten Zellen.Clears the current selection by unselecting all selected cells.

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

Beispiele

Im folgenden Codebeispiel wird die Auswahl von DataGridViewgelöscht.The following code example clears the selection of the DataGridView. Fügen Sie zum Ausführen dieses Beispiels den Code in ein Formular ein, das DataGridView ein dataGridView1 mit dem Button Namen clearSelectionButtonund ein mit dem Namen enthält, und stellen Sie sicher, dass alle Ereignisse mit ihren Ereignis Handlern verknüpft sind.To run this example, paste the code into a form that contains a DataGridView named dataGridView1 and a Button named clearSelectionButton, and ensure all events are associated with their event handlers.

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 jede Spalte und jede Selected Zeile auf falsefestgelegt.When this method is called, each column and row's Selected property is set to false.

Siehe auch

Gilt für: