ItemCheckEventArgs.NewValue Özellik
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
İşaretlenecek, işaretlenmemiş veya belirsiz öğe için onay kutusunun ayarlanıp ayarlanmayacağını belirten bir değer alır veya ayarlar.
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, setPublic Property NewValue As CheckStateÖzellik Değeri
Değerlerden CheckState biri.
Örnekler
Aşağıdaki kod örneğinde bu üyenin kullanımı gösterilmektedir. Örnekte, bir olay işleyicisi olayın oluşumunu CheckedListBox.ItemCheck raporlar. Bu rapor, olayın ne zaman gerçekleştiğini öğrenmenize yardımcı olur ve hata ayıklamada size yardımcı olabilir. Birden çok olayı veya sık gerçekleşen olayları raporlamak için, iletisini ile Console.WriteLine değiştirmeyi MessageBox.Show veya çok satırlı TextBoxbir iletiye eklemeyi göz önünde bulundurun.
Örnek kodu çalıştırmak için, adlı CheckedListBox1bir tür CheckedListBox örneği içeren bir projeye yapıştırın. Ardından olay işleyicisinin olayla ilişkilendirildiğinden CheckedListBox.ItemCheck emin olun.
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
Açıklamalar
Bu özellik, denetim tarafından denetim durumu değiştirilmeden önce belirtilen öğe için yeni denetim durumunu belirlemenizi CheckedListBox sağlar. Yeni denetim durumunu belirlemeye ek olarak, bu özelliği olayın olay işleyicisinde ItemCheck kullanarak durumu belirtilenden farklı bir denetim durumuna değiştirebilirsiniz. Örneğin, kullanıcı uygulamanızın durumuna bağlı olarak denetlenmemesi gerektiğini belirlediğiniz öğesinin yanına onay CheckedListBox işareti yerleştirdiyse, bu özelliği önceki ayarına veya farklı bir onay durumuna ayarlayarak onay işareti durumundaki değişikliği geçersiz kılabilirsiniz.
