ItemCheckEventArgs.NewValue Özellik

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

İş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, set

Public Property NewValue As CheckState

Özellik Değeri

CheckState

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.

Ayrıca bkz.

• CurrentValue