DataGridView.ClearSelection Metoda

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Anuluje zaznaczenie aktualnie zaznaczonych komórek.

Przeciążenia

ClearSelection(Int32, Int32, Boolean)	Anuluje zaznaczenie wszystkich aktualnie zaznaczonych komórek z wyjątkiem wskazanego, opcjonalnie zapewniając, że wskazana komórka jest zaznaczona.
ClearSelection()	Czyści bieżące zaznaczenie, usuwając zaznaczenie wszystkich zaznaczonych komórek.

ClearSelection(Int32, Int32, Boolean)

Anuluje zaznaczenie wszystkich aktualnie zaznaczonych komórek z wyjątkiem wskazanego, opcjonalnie zapewniając, że wskazana komórka jest zaznaczona.

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)

Parametry

columnIndexException

Int32

Indeks kolumny do wykluczenia.

rowIndexException

Int32

Indeks wierszy do wykluczenia.

selectExceptionElement

Boolean

true aby wybrać wykluczona komórkę, wiersz lub kolumnę; false zachować swój pierwotny stan.

Wyjątki

ArgumentOutOfRangeException

columnIndexException wartość jest większa niż najwyższy indeks kolumny.

-lub- columnIndexException wartość jest mniejsza niż -1, gdy SelectionMode wartość to FullRowSelect; w przeciwnym razie columnIndexException wartość jest mniejsza niż 0.

-lub- rowIndexException jest większy niż najwyższy indeks wierszy.

-lub- rowIndexException wartość jest mniejsza niż -1, gdy SelectionMode wartość to FullColumnSelect; w przeciwnym razie rowIndexException wartość jest mniejsza niż 0.

Uwagi

Wartość rowIndexException -1 reprezentuje nagłówek kolumny, a columnIndexException wartość -1 reprezentuje nagłówek wiersza.

Ta metoda jest przydatna do czyszczenia bieżącego zaznaczenia bez anulowania zaznaczenia komórki, wiersza lub kolumny wskazanej przez indeksy wyjątków.

SelectionMode Jeśli wartość właściwości zezwala na wybór poszczególnych komórek, ta metoda ustawia Selected właściwość każdej komórki na falsewartość , z wyłączeniem komórki w wierszu i określonej kolumnie. SelectionMode Jeśli wartość właściwości zezwala na wybór pełnego wiersza lub kolumny, ta metoda ustawia Selected również właściwość każdego wiersza lub kolumny na falsewartość , z wyłączeniem wiersza lub kolumny zawierającej określoną komórkę.

Wykluczona komórka, wiersz lub kolumna może być w wybranym stanie, gdy jest wywoływana ta metoda. Ta metoda wybiera ją, jeśli wartość parametru selectExceptionElement to true. W zależności od trybu zaznaczenia można również wybrać cały wiersz lub kolumnę w wyniku.

Zobacz też

• SelectionMode
• Selected
• Selected
• DataGridView — Formant (Formularze systemu Windows)

ClearSelection()

Czyści bieżące zaznaczenie, usuwając zaznaczenie wszystkich zaznaczonych komórek.

public:
 void ClearSelection();

public void ClearSelection ();

member this.ClearSelection : unit -> unit

Public Sub ClearSelection ()

Przykłady

Poniższy przykład kodu czyści wybór elementu DataGridView. Aby uruchomić ten przykład, wklej kod w formularzu zawierającym DataGridView nazwane i nazwane Button dataGridView1 clearSelectionButton, a następnie upewnij się, że wszystkie zdarzenia są skojarzone z ich procedurami obsługi zdarzeń.

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

Uwagi

Po wywołaniu tej metody każda kolumna i właściwość wiersza jest ustawiona Selected na falsewartość .

Zobacz też

• DataGridView — Formant (Formularze systemu Windows)