ItemCheckEventArgs.NewValue Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient ou définit une valeur qui indique si la case à cocher de l'élément doit être définie avec l'état activé, désactivé ou indéterminé.
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 CheckStateValeur de propriété
Une des valeurs de l'objet CheckState.
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 à savoir 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 par ou d’ajouter le message à un multiligne TextBox.
Pour exécuter l’exemple de code, collez-le dans un projet qui contient un instance de type CheckedListBox nommé 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 case activée de l’élément spécifié avant que l’état case activée soit modifié par le CheckedListBox contrôle. En plus de déterminer le nouvel état case activée, vous pouvez utiliser cette propriété dans un gestionnaire d’événements pour l’événement ItemCheck afin de modifier l’état vers un état case activée différent de celui spécifié. Par exemple, si l’utilisateur a placé une marque de case activée en regard d’un élément dans le 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 marque case activée en définissant cette propriété sur son paramètre précédent ou sur un autre état case activée.
