DataGridView.CurrentCell Properti

Referensi

Definisi

Ruang nama:: System.Windows.Forms

Rakitan:: System.Windows.Forms.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mendapatkan atau mengatur sel yang saat ini aktif.

public:
 property System::Windows::Forms::DataGridViewCell ^ CurrentCell { System::Windows::Forms::DataGridViewCell ^ get(); void set(System::Windows::Forms::DataGridViewCell ^ value); };

[System.ComponentModel.Browsable(false)]
public System.Windows.Forms.DataGridViewCell CurrentCell { get; set; }

[System.ComponentModel.Browsable(false)]
public System.Windows.Forms.DataGridViewCell? CurrentCell { get; set; }

[<System.ComponentModel.Browsable(false)>]
member this.CurrentCell : System.Windows.Forms.DataGridViewCell with get, set

Public Property CurrentCell As DataGridViewCell

Nilai Properti

DataGridViewCell

DataGridViewCell yang mewakili sel saat ini, atau null jika tidak ada sel saat ini. Defaultnya adalah sel pertama di kolom pertama atau null jika tidak ada sel dalam kontrol.

Atribut: BrowsableAttribute

Pengecualian

InvalidOperationException

Nilai properti ini tidak dapat disetel karena perubahan pada sel saat ini tidak dapat diterapkan atau dibatalkan.

-atau-

Sel yang ditentukan saat mengatur properti ini berada dalam baris atau kolom tersembunyi.

Panggilan re-entrant hanya diperbolehkan ketika DataGridView terikat ke DataSource. Lampirkan kembali hasil panggilan dari perubahan pada data yang mendasar.

ArgumentException

Sel yang ditentukan saat mengatur properti ini tidak ada di DataGridView.

Contoh

Contoh kode berikut mengilustrasikan cara memastikan bahwa sel saat ini terlihat setelah mengurutkan dengan mengatur FirstDisplayedCell properti ke sel yang diambil melalui CurrentCell properti . Kode ini hanya berfungsi dengan kontrol yang tidak terikat DataGridView . Dengan kontrol yang DataGridView terikat ke sumber data eksternal, sel saat ini tidak secara otomatis bertahan saat mengurutkan.

Untuk menjalankan contoh ini, tempelkan kode berikut ke dalam formulir yang berisi bernama DataGridViewdataGridView1. Di C#, Anda juga harus menyambungkan Sorted peristiwa ke penanganan aktivitas.

private void dataGridView1_Sorted(object sender, EventArgs e)
{
    this.dataGridView1.FirstDisplayedCell = this.dataGridView1.CurrentCell;
}

Private Sub dataGridView1_Sorted(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles dataGridView1.Sorted

    Me.dataGridView1.FirstDisplayedCell = Me.dataGridView1.CurrentCell

End Sub

Keterangan

Saat Anda mengatur sel sebagai sel saat ini, sel tersebut akan digulir ke tampilan jika saat ini tidak ditampilkan. Sel saat ini tidak dapat berupa sel header, sel yang dinonaktifkan, atau sel dalam baris atau kolom tersembunyi.

Anda dapat mengatur properti ini ke null untuk menghapus persegi panjang fokus untuk sementara, tetapi ketika kontrol menerima fokus dan nilai properti ini adalah null, properti ini secara otomatis diatur ke nilai FirstDisplayedCell properti.

Saat Anda mengubah nilai properti ini, SelectionChanged peristiwa terjadi sebelum CurrentCellChanged peristiwa. Setiap SelectionChanged penanganan aktivitas yang CurrentCell mengakses properti saat ini akan mendapatkan nilai sebelumnya.

Saat Anda mengikat ke DataGridView sumber data eksternal, properti ini diatur ulang ke nilai defaultnya.

Berlaku untuk

Share via