ItemCheckEventArgs.NewValue Proprietà

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

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, set

Public Property NewValue As CheckState

Valore della proprietà

CheckState

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.

Vedi anche

• CurrentValue