Partager via


ItemCheckEventArgs.NewValue Propriété

Définition

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, set
Public Property NewValue As CheckState

Valeur 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.

S’applique à

Voir aussi