ItemCheckEventArgs.NewValue Свойство

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Возвращает или задает значение, определяющее состояния флажка элемента: установлен, не установлен или неопределенное состояние.

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

Значение свойства

CheckState

Одно из значений перечисления CheckState.

Примеры

В следующем примере кода показано использование этого элемента. В этом примере обработчик событий сообщает о возникновении CheckedListBox.ItemCheck события. Этот отчет поможет вам узнать, когда происходит событие, и поможет вам в отладке. Чтобы сообщить о нескольких событиях или о событиях, которые происходят часто, рекомендуется заменить MessageBox.ShowConsole.WriteLine сообщение или добавить его в многостроочный TextBox.

Чтобы выполнить пример кода, вставьте его в проект, содержащий экземпляр типа CheckedListBox с именем CheckedListBox1. Затем убедитесь, что обработчик событий связан с событием 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

Комментарии

Это свойство позволяет определить новое состояние проверка для указанного элемента до изменения состояния проверка элементом CheckedListBox управления. Помимо определения нового состояния проверка, это свойство можно использовать в обработчике событий, ItemCheck чтобы изменить состояние проверка, отличное от указанного. Например, если пользователь поместил проверка метку рядом с элементом в CheckedListBox объекте , который, как вы определили, не должен проверяться на основе состояния приложения, можно переопределить изменение состояния метки проверка, задав для этого свойства предыдущее значение или другое состояние проверка.

См. также раздел

• CurrentValue