ListView.BeforeLabelEdit Event

Definition

Occurs when the user starts editing the label of an item.

C#
public event System.Windows.Forms.LabelEditEventHandler BeforeLabelEdit;
C#
public event System.Windows.Forms.LabelEditEventHandler? BeforeLabelEdit;

Event Type

Examples

The following code example demonstrates handling the BeforeLabelEdit event and using the LabelEditEventArgs.Item and LabelEditEventArgs.CancelEdit properties. To run the example, paste the following code into a form that contains a ListView control named ListView1 and populated with at least three items. Ensure the event handler in the example is associated with its event.

C#
private void ListView1_BeforeLabelEdit(object sender, 
    System.Windows.Forms.LabelEditEventArgs e)
{
    // Allow all but the first two items of the list to 
    // be modified by the user.
    if (e.Item<2)
    {
        e.CancelEdit = true;
    }
}

Remarks

The BeforeLabelEdit event occurs when the user starts 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 BeforeLabelEdit event is not raised; all user attempts to edit item labels are automatically rejected.

For more information about handling events, see Handling and Raising Events.

Applies to

Product Versions
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

See also