ItemCheckEventArgs.NewValue Özellik

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Kaynak:

ItemCheckEventArgs.cs

İş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, olay işleyicisi olayın oluşumunu CheckedListBox.ItemCheck bildirir. 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 MessageBox.Show değiştirmeyi Console.WriteLine veya çok satırlı TextBoxbir iletiye eklemeyi göz önünde bulundurun.

Örnek kodu çalıştırmak için, adlı CheckedListBoxtürünün CheckedListBox1 bir örneğini 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 işleyicisinde ItemCheck kullanarak durumu belirtilenden farklı bir denetim durumuna değiştirebilirsiniz. Örneğin, kullanıcı sizin belirlemiş olduğunuz öğenin CheckedListBox yanına onay işareti koyduysa, uygulamanızın durumuna göre denetlenmemelidir, 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