ItemCheckEventArgs.NewValue 属性
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
获取或设置一个值，该值指示是否为要选中、未选中或不确定的项目设置复选框。
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 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 旁边放置了一个复选标记，则根据应用程序的状态不应进行检查，则可以通过将此属性设置为其以前的设置或其他检查状态来替代复选标记状态的更改。
