ListView.ItemChecked 事件


当某项的选中状态更改时发生。Occurs when the checked state of an item changes.

 event System::Windows::Forms::ItemCheckedEventHandler ^ ItemChecked;
public event System.Windows.Forms.ItemCheckedEventHandler ItemChecked;
member this.ItemChecked : System.Windows.Forms.ItemCheckedEventHandler 
Public Custom Event ItemChecked As ItemCheckedEventHandler 


下面的代码示例演示如何使用此成员。The following code example demonstrates the use of this member. 在此示例中,事件处理程序报告 ItemChecked 事件的发生。In the example, an event handler reports on the occurrence of the ItemChecked event. 此报表可帮助你了解何时发生事件,并可帮助你进行调试。This report helps you to learn when the event occurs and can assist you in debugging. 若要报告多个事件或频繁发生的事件,请考虑将 MessageBox.Show 替换为 Console.WriteLine 或将消息附加到多行 TextBox中。To report on multiple events or on events that occur frequently, consider replacing MessageBox.Show with Console.WriteLine or appending the message to a multiline TextBox.

若要查看其他示例,请参阅 ItemCheck 事件。For another example, see the ItemCheck event. 如果将事件处理程序附加到 ItemChecked 事件,则此代码将同样适用。The code there works equally well if the event handler is attached to the ItemChecked event.

若要运行此示例代码,请将其粘贴到包含名为 ListView1ListView 类型实例的项目中。To run this example code, paste it into a project that contains an instance of type ListView named ListView1. 然后,确保事件处理程序与 ItemChecked 事件关联。Then ensure that the event handler is associated with the ItemChecked event.

private void ListView1_ItemChecked(Object sender, ItemCheckedEventArgs e) {

System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "Item", e.Item );
MessageBox.Show(messageBoxCS.ToString(), "ItemChecked Event" );
Private Sub ListView1_ItemChecked(sender as Object, e as ItemCheckedEventArgs) _ 
     Handles ListView1.ItemChecked

    Dim messageBoxVB as New System.Text.StringBuilder()
    messageBoxVB.AppendFormat("{0} = {1}", "Item", e.Item)
    MessageBox.Show(messageBoxVB.ToString(),"ItemChecked Event")

End Sub


此事件类似于 ItemCheck 事件,但在检查项后引发。This event is similar to the ItemCheck event, but is raised after the item has been checked.

有关处理事件的详细信息,请参阅处理和引发事件For more information about handling events, see Handling and Raising Events.