ListView.BeforeLabelEdit Événement
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Se produit lorsque l'utilisateur commence à modifier l'étiquette d'un élément.
public:
event System::Windows::Forms::LabelEditEventHandler ^ BeforeLabelEdit;
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
Type d'événement
Exemples
L’exemple de code suivant illustre la gestion de l’événement BeforeLabelEdit et l’utilisation des LabelEditEventArgs.Item propriétés et LabelEditEventArgs.CancelEdit . 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. Vérifiez que le gestionnaire d’événements dans l’exemple est associé à son événement.
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
L’événement BeforeLabelEdit se produit lorsque l’utilisateur commence à modifier le texte d’un élément. Si le gestionnaire d’événements annule cet événement, l’utilisateur ne peut pas modifier le texte. Vous pouvez utiliser cet événement pour empêcher l’utilisateur de modifier des éléments spécifiques dans le ListView contrôle. Si la LabelEdit propriété du ListView contrôle est définie sur false
, l’événement BeforeLabelEdit n’est pas déclenché ; toutes les tentatives d’utilisateur pour modifier les étiquettes d’élément sont automatiquement rejetées.
Pour plus d'informations sur la gestion des événements, voir gestion et déclenchement d’événements.