LabelEditEventArgs Classe

Définition

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
LabelEditEventArgs

Exemples

L’exemple de code suivant illustre la gestion de l’événement ListView.BeforeLabelEdit et l’utilisation des Item propriétés et CancelEdit . 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 le légende d’un ListViewItem et le légende une fois qu’il a été modifié 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 utilisateur avant de valider la modification.

Notes

É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

LabelEditEventArgs(Int32)

Initialise une nouvelle instance de la classe LabelEditEventArgs avec l'index spécifié de ListViewItem en vue d'une modification.

LabelEditEventArgs(Int32, String)

Initialise une nouvelle instance de la classe LabelEditEventArgs avec l'index spécifié de ListViewItem qui est en train d'être modifié et le nouveau texte pour l'étiquette de ListViewItem.

Propriétés

CancelEdit

Obtient ou définit une valeur indiquant si les modifications apportées à l'étiquette de ListViewItem doivent être annulées.

Item

Obtient l'index de base zéro de ListViewItem, contenant l'étiquette à modifier.

Label

Obtient le nouveau texte assigné à l'étiquette de ListViewItem.

Méthodes

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)

S’applique à

Voir aussi