ItemCheckEventArgs.NewValue Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene o imposta un valore che indica se impostare la casella di controllo per l'elemento che deve essere selezionato, non selezionato o indeterminato.
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 CheckStateValore della proprietà
Uno dei valori di CheckState.
Esempio
Nell'esempio di codice seguente viene illustrato l'uso di questo membro. Nell'esempio un gestore eventi segnala l'occorrenza dell'evento CheckedListBox.ItemCheck . Questo report consente di apprendere quando si verifica l'evento e può essere utile per eseguire il debug. Per segnalare più eventi o eventi che si verificano spesso, è consigliabile sostituire MessageBox.Show con Console.WriteLine o aggiungere il messaggio a una multilinea TextBox.
Per eseguire il codice di esempio, incollarlo in un progetto contenente un'istanza di tipo CheckedListBox denominata CheckedListBox1. Assicurarsi quindi che il gestore eventi sia associato all'evento 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
Commenti
Questa proprietà consente di determinare il nuovo stato di controllo per l'elemento specificato prima che lo CheckedListBox stato di controllo venga modificato dal controllo. Oltre a determinare il nuovo stato di controllo, è possibile usare questa proprietà in un gestore eventi per ItemCheck modificare lo stato in uno stato di controllo diverso rispetto a quello specificato. Ad esempio, se l'utente ha inserito un segno di spunta accanto a un elemento nell'oggetto CheckedListBox determinato non deve essere controllato in base allo stato dell'applicazione, è possibile eseguire l'override della modifica nello stato del segno di spunta impostando questa proprietà sull'impostazione precedente o su uno stato di controllo diverso.
