ListView.BeforeLabelEdit ListView.BeforeLabelEdit ListView.BeforeLabelEdit ListView.BeforeLabelEdit Event

Définition

Se produit lorsque l'utilisateur commence à modifier l'étiquette d'un élément.Occurs when the user starts editing the label of an item.

public:
 event System::Windows::Forms::LabelEditEventHandler ^ BeforeLabelEdit;
public event System.Windows.Forms.LabelEditEventHandler BeforeLabelEdit;
member this.BeforeLabelEdit : System.Windows.Forms.LabelEditEventHandler 
Public Custom Event BeforeLabelEdit As LabelEditEventHandler 

Exemples

L’exemple de code suivant illustre la gestion du BeforeLabelEdit événement et à l’aide de la LabelEditEventArgs.Item et LabelEditEventArgs.CancelEdit propriétés.The following code example demonstrates handling the BeforeLabelEdit event and using the LabelEditEventArgs.Item and LabelEditEventArgs.CancelEdit properties. Pour exécuter l’exemple, collez le code suivant dans un formulaire qui contient un ListView contrôle nommé ListView1 et rempli avec au moins trois éléments.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. Vérifiez que le Gestionnaire d’événements dans l’exemple est associé à son événement.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;
   }
}
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;
	}
}

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

Remarques

Le BeforeLabelEdit événement se produit lorsque l’utilisateur commence à modifier le texte d’un élément.The BeforeLabelEdit event occurs when the user starts modifying the text for an item. Si le Gestionnaire d’événements annule cet événement, l’utilisateur ne peut pas modifier le texte.If the event handler cancels this event, the user cannot edit the text. Vous pouvez utiliser cet événement pour empêcher l’utilisateur de modifier des éléments spécifiques dans le ListView contrôle.You can use this event to prevent the user from editing specific items in the ListView control. Si le LabelEdit propriété de la ListView contrôle est défini sur false, le BeforeLabelEdit événement n’est pas déclenché ; toutes les tentatives d’utilisateur pour modifier les étiquettes d’élément sont automatiquement rejetés.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.

Pour plus d'informations sur la gestion des événements, voir gestion et déclenchement d’événements.For more information about handling events, see Handling and Raising Events.

S’applique à

Voir aussi