Teilen über


ItemCheckEventArgs.NewValue Eigenschaft

Definition

Ruft einen Wert ab, der angibt, ob das Kontrollkästchen für das Element auf einen aktivierten, deaktivierten oder einen unbestimmten Zustand festgelegt werden soll, oder legt den Wert fest.

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

Eigenschaftswert

Einer der CheckState-Werte.

Beispiele

Im folgenden Codebeispiel wird die Verwendung dieses Members veranschaulicht. Im Beispiel meldet ein Ereignishandler das Auftreten des Ereignisses CheckedListBox.ItemCheck . Dieser Bericht hilft Ihnen, zu erfahren, wann das Ereignis eintritt, und kann Ihnen beim Debuggen helfen. Um über mehrere Ereignisse oder ereignisse zu berichten, die häufig auftreten, sollten Sie erwägen, die Nachricht durch Console.WriteLine ein mehrzeilesiges TextBoxzu ersetzen MessageBox.Show oder anzufügen.

Um den Beispielcode auszuführen, fügen Sie ihn in ein Projekt ein, das eine instance vom Typ CheckedListBox enthältCheckedListBox1. Stellen Sie dann sicher, dass der Ereignishandler dem CheckedListBox.ItemCheck Ereignis zugeordnet ist.

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

Hinweise

Mit dieser Eigenschaft können Sie den neuen Überprüfungsstatus für das angegebene Element bestimmen, bevor der Überprüfungszustand vom CheckedListBox Steuerelement geändert wird. Zusätzlich zum Bestimmen des neuen Überprüfungszustands können Sie diese Eigenschaft in einem Ereignishandler für das ItemCheck Ereignis verwenden, um den Zustand in einen anderen Überprüfungszustand als den angegebenen zu ändern. Wenn der Benutzer beispielsweise ein Häkchen neben einem Element in der CheckedListBox gesetzt hat, das basierend auf dem Status Ihrer Anwendung nicht überprüft werden soll, können Sie die Änderung des Häkchenzustands überschreiben, indem Sie diese Eigenschaft auf ihre vorherige Einstellung oder auf einen anderen Prüfzustand festlegen.

Gilt für:

Weitere Informationen