Occurs when the user starts editing the label of an item.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
The event occurs when the user begins modifying the text for an item. If the event handler cancels this event, the user cannot edit the text. You can use this event to prevent the user from editing specific items in the ListView control. If the LabelEdit property of the ListView control is set to false, the event is not raised; all user attempts to edit item labels are automatically rejected.
For more information about handling events, see Consuming Events.
The following code example demonstrates handling the event and using the LabelEditEventArgs.Item and LabelEditEventArgs.CancelEdit properties. To run the example, paste the following code into a form containing a ListView control named ListView1 and populated with at least three items. Ensure the event handler in the example is associated with its event.
Private Sub ListView1_BeforeLabelEdit(ByVal sender As Object, _ ByVal e As System.Windows.Forms.LabelEditEventArgs) _ Handles ListView1.BeforeLabelEdit ' Allow all but the first two items of the list to be modified by ' the user. If (e.Item < 2) Then e.CancelEdit = True End If End Sub
The following code example demonstrates handling the ListView.BeforeLabelEdit event and using the EditLabelEventArgs.Item and CancelEdit properties. To run the example, paste the following code in a form containing a ListView control named ListView1 and populated with at least 3 items.
Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98
The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.