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。

若要运行示例代码，请将其粘贴到包含名为 CheckedListBox1的类型的CheckedListBox实例的项目中。 然后，确保事件处理程序与 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