Udostępnij za pośrednictwem


ItemCheckEventArgs.NewValue Właściwość

Definicja

Pobiera lub ustawia wartość wskazującą, czy ustawić pole wyboru dla elementu do zaznaczenia, niezaznaczone lub nieokreślone.

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

Wartość właściwości

CheckState Jedna z wartości.

Przykłady

W poniższym przykładzie kodu pokazano użycie tego elementu członkowskiego. W tym przykładzie program obsługi zdarzeń zgłasza wystąpienie CheckedListBox.ItemCheck zdarzenia. Ten raport pomaga dowiedzieć się, kiedy wystąpi zdarzenie, i może pomóc w debugowaniu. Aby zgłosić wiele zdarzeń lub często występujących zdarzeń, rozważ zastąpienie MessageBox.Show komunikatu ciągiem Console.WriteLine lub dołączenie go do wielowierszowego TextBoxelementu .

Aby uruchomić przykładowy kod, wklej go w projekcie zawierającym wystąpienie typu CheckedListBox o nazwie CheckedListBox1. Następnie upewnij się, że program obsługi zdarzeń jest skojarzony ze zdarzeniem 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

Uwagi

Ta właściwość umożliwia określenie nowego stanu sprawdzania dla określonego elementu przed zmianą stanu sprawdzania przez kontrolkę CheckedListBox . Oprócz określenia nowego stanu sprawdzania można użyć tej właściwości w procedurze obsługi zdarzeń dla ItemCheck zdarzenia, aby zmienić stan na inny niż określony. Jeśli na przykład użytkownik umieścił znacznik wyboru obok określonego elementu, CheckedListBox nie powinien być sprawdzany na podstawie stanu aplikacji, można przesłonić zmianę stanu znacznika wyboru, ustawiając tę właściwość na poprzednie ustawienie lub inny stan sprawdzania.

Dotyczy

Zobacz też