LabelEditEventArgs Classe

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

LabelEditEventArgs.cs

Fournit des données pour les événements BeforeLabelEdit et AfterLabelEdit.

public ref class LabelEditEventArgs : EventArgs

public class LabelEditEventArgs : EventArgs

type LabelEditEventArgs = class
    inherit EventArgs

Public Class LabelEditEventArgs
Inherits EventArgs

Héritage

Object

EventArgs

LabelEditEventArgs

Exemples

L’exemple de code suivant illustre la gestion de l’événement ListView.BeforeLabelEdit et l’utilisation des propriétés et CancelEdit des Item propriétés. Pour exécuter l’exemple, collez le code suivant dans un formulaire contenant un ListView contrôle nommé ListView1 et rempli avec au moins 3 éléments. Vérifiez que tous les événements sont associés à leurs méthodes de gestion des événements.

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

A LabelEditEventArgs spécifie l’index et la légende d’une ListViewItem légende après sa modification par l’utilisateur. Cette classe fournit également une CancelEdit propriété. Vous pouvez utiliser cette propriété dans un gestionnaire d’événements ListView.BeforeLabelEdit pour empêcher l’utilisateur de modifier l’étiquette. Vous pouvez également l’utiliser dans un gestionnaire d’événements ListView.AfterLabelEdit pour rétablir la modification, en retournant l’étiquette à sa valeur d’origine. Cela est utile lorsque vous souhaitez valider l’entrée de l’utilisateur avant de valider la modification.

Note

Étant donné que l’événement ListView.AfterLabelEdit a lieu avant la validation de la modification d’étiquette, l’appel de la ListView.Sort méthode dans un gestionnaire pour cet événement trie l’élément à l’aide de la valeur d’origine.

Constructeurs

Nom	Description
LabelEditEventArgs(Int32, String)	Initialise une nouvelle instance de la LabelEditEventArgs classe avec l’index spécifié pour la ListViewItem modification et le nouveau texte de l’étiquette du ListViewItem.
LabelEditEventArgs(Int32)	Initialise une nouvelle instance de la LabelEditEventArgs classe avec l’index spécifié à modifier ListViewItem .

Propriétés

Nom	Description
CancelEdit	Obtient ou définit une valeur indiquant si les modifications apportées à l’étiquette de l’étiquette ListViewItem doivent être annulées.
Item	Obtient l’index de base zéro de l’étiquette ListViewItem à modifier.
Label	Obtient le nouveau texte affecté à l’étiquette du ListViewItem.

Voir aussi

• ListView
• ListViewItem
• BeforeLabelEdit
• AfterLabelEdit