ItemCheckEventArgs.NewValue Properti

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Mendapatkan atau mengatur nilai yang menunjukkan apakah akan mengatur kotak centang untuk item yang akan dicentang, tidak dicentang, atau tidak ditentukan.

public:
 property System::Windows::Forms::CheckState NewValue { System::Windows::Forms::CheckState get(); void set(System::Windows::Forms::CheckState value); };

public System.Windows.Forms.CheckState NewValue { get; set; }

member this.NewValue : System.Windows.Forms.CheckState with get, set

Public Property NewValue As CheckState

Nilai Properti

CheckState

Salah CheckState satu nilai.

Contoh

Contoh kode berikut menunjukkan penggunaan anggota ini. Dalam contoh, penanganan aktivitas melaporkan terjadinya CheckedListBox.ItemCheck peristiwa. Laporan ini membantu Anda mempelajari kapan peristiwa terjadi dan dapat membantu Anda dalam penelusuran kesalahan. Untuk melaporkan beberapa peristiwa atau pada peristiwa yang sering terjadi, pertimbangkan untuk mengganti MessageBox.Show dengan Console.WriteLine atau menambahkan pesan ke multibaris TextBox.

Untuk menjalankan kode contoh, tempelkan ke dalam proyek yang berisi instans jenis CheckedListBox bernama CheckedListBox1. Kemudian pastikan bahwa penanganan aktivitas dikaitkan dengan CheckedListBox.ItemCheck peristiwa.

private void CheckedListBox1_ItemCheck(Object sender, ItemCheckEventArgs e) {

System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "Index", e.Index );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "NewValue", e.NewValue );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "CurrentValue", e.CurrentValue );
messageBoxCS.AppendLine();
MessageBox.Show(messageBoxCS.ToString(), "ItemCheck Event" );
}

Private Sub CheckedListBox1_ItemCheck(sender as Object, e as ItemCheckEventArgs) _ 
     Handles CheckedListBox1.ItemCheck

    Dim messageBoxVB as New System.Text.StringBuilder()
    messageBoxVB.AppendFormat("{0} = {1}", "Index", e.Index)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "NewValue", e.NewValue)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "CurrentValue", e.CurrentValue)
    messageBoxVB.AppendLine()
    MessageBox.Show(messageBoxVB.ToString(),"ItemCheck Event")

End Sub

Keterangan

Properti ini memungkinkan Anda menentukan status pemeriksaan baru untuk item yang ditentukan sebelum status pemeriksaan diubah oleh CheckedListBox kontrol. Selain menentukan status pemeriksaan baru, Anda dapat menggunakan properti ini dalam penanganan aktivitas untuk ItemCheck peristiwa guna mengubah status ke status pemeriksaan yang berbeda dari yang ditentukan. Misalnya, jika pengguna menempatkan tanda centang di samping item dalam CheckedListBox yang telah Anda tentukan tidak boleh diperiksa berdasarkan status aplikasi Anda, Anda dapat mengambil alih perubahan status tanda centang dengan mengatur properti ini ke pengaturan sebelumnya atau ke status pemeriksaan yang berbeda.

Lihat juga

• CurrentValue