Export (0) Print
Expand All

ListView::BeforeLabelEdit Event

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

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public:
 event LabelEditEventHandler^ BeforeLabelEdit {
	void add (LabelEditEventHandler^ value);
	void remove (LabelEditEventHandler^ value);
}

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 Consuming Events.

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.


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;
   }
}



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.


.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Community Additions

ADD
Show:
© 2015 Microsoft