DataGridView.ClearSelection Metode

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Membatalkan pilihan sel terpilih saat ini.

Overload

Nama	Deskripsi
ClearSelection(Int32, Int32, Boolean)	Membatalkan pilihan semua sel yang saat ini dipilih kecuali yang ditunjukkan, secara opsional memastikan bahwa sel yang ditunjukkan dipilih.
ClearSelection()	Menghapus pilihan saat ini dengan membatalkan pilihan semua sel terpilih.

ClearSelection(Int32, Int32, Boolean)

Sumber:

DataGridView.Methods.cs

Membatalkan pilihan semua sel yang saat ini dipilih kecuali yang ditunjukkan, secara opsional memastikan bahwa sel yang ditunjukkan dipilih.

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

Indeks kolom yang akan dikecualikan.

rowIndexException

Int32

Indeks baris yang akan dikecualikan.

selectExceptionElement

Boolean

true untuk memilih sel, baris, atau kolom yang dikecualikan; false untuk mempertahankan status aslinya.

Pengecualian

ArgumentOutOfRangeException

columnIndexException lebih besar dari indeks kolom tertinggi.

-atau-

columnIndexException kurang dari -1 ketika SelectionMode adalah FullRowSelect; jika tidak, columnIndexException kurang dari 0.

-atau-

rowIndexException lebih besar dari indeks baris tertinggi.

-atau-

rowIndexException kurang dari -1 ketika SelectionMode adalah FullColumnSelect; jika tidak, rowIndexException kurang dari 0.

Keterangan

Nilai rowIndexException -1 mewakili header kolom, dan columnIndexException nilai -1 mewakili header baris.

Metode ini berguna untuk menghapus pilihan saat ini tanpa membatalkan pilihan sel, baris, atau kolom yang ditunjukkan oleh indeks pengecualian.

SelectionMode Jika nilai properti memungkinkan pemilihan sel individual, metode ini mengatur Selected properti setiap sel ke false, tidak termasuk sel dalam baris dan kolom yang ditentukan. SelectionMode Jika nilai properti memungkinkan pemilihan baris atau kolom penuh, metode ini juga mengatur Selected properti setiap baris atau kolom ke false, tidak termasuk baris atau kolom yang berisi sel yang ditentukan.

Sel, baris, atau kolom yang dikecualikan mungkin atau mungkin tidak berada dalam status terpilih saat metode ini dipanggil. Metode ini memilihnya jika selectExceptionElement nilai parameter adalah true. Bergantung pada mode pemilihan, seluruh baris atau kolom juga dapat dipilih sebagai hasilnya.

Lihat juga

• SelectionMode
• Selected
• Selected
• Kontrol DataGridView (Formulir Windows)

ClearSelection()

Sumber:

DataGridView.Methods.cs

Menghapus pilihan saat ini dengan membatalkan pilihan semua sel terpilih.

public:
 void ClearSelection();

public void ClearSelection();

member this.ClearSelection : unit -> unit

Public Sub ClearSelection ()

Contoh

Contoh kode berikut menghapus pilihan DataGridView. Untuk menjalankan contoh ini, tempelkan kode ke dalam formulir yang berisi DataGridView bernama dataGridView1 dan bernama ButtonclearSelectionButton, dan pastikan semua peristiwa dikaitkan dengan penanganan aktivitas mereka.

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

Keterangan

Ketika metode ini dipanggil, setiap properti kolom dan baris Selected diatur ke false.

Lihat juga

• Kontrol DataGridView (Formulir Windows)