ItemCheckEventArgs.NewValue Propriété

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

Valeur de propriété

Une des CheckState valeurs.

Exemples

L’exemple de code suivant illustre l’utilisation de ce membre. Dans l’exemple, un gestionnaire d’événements signale l’occurrence de l’événement CheckedListBox.ItemCheck . Ce rapport vous aide à apprendre quand l’événement se produit et peut vous aider à déboguer. Pour signaler plusieurs événements ou événements qui se produisent fréquemment, envisagez de MessageBox.ShowConsole.WriteLine remplacer ou d’ajouter le message à un multiligne TextBox.

Pour exécuter l’exemple de code, collez-le dans un projet qui contient une instance de type CheckedListBox nommée CheckedListBox1. Vérifiez ensuite que le gestionnaire d’événements est associé à l’événement CheckedListBox.ItemCheck .

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

Remarques

Cette propriété vous permet de déterminer le nouvel état de vérification de l’élément spécifié avant la modification de l’état de vérification par le CheckedListBox contrôle. En plus de déterminer le nouvel état de vérification, vous pouvez utiliser cette propriété dans un gestionnaire d’événements pour que l’événement ItemCheck change l’état en un état de vérification différent de celui spécifié. Par exemple, si l’utilisateur a placé une coche en regard d’un élément dans celui CheckedListBox que vous avez déterminé ne doit pas être vérifié en fonction de l’état de votre application, vous pouvez remplacer la modification de l’état de la coche en définissant cette propriété sur son paramètre précédent ou sur un autre état de vérification.

Voir aussi

• CurrentValue