ItemCheckEventArgs.NewValue Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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, setPublic Property NewValue As CheckStateWartość 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.
