ListView.BeforeLabelEdit-Ereignis

Artikel
08/20/2007

Tritt ein, wenn der Benutzer mit dem Bearbeiten der Bezeichnung eines Elements beginnt.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Public Event BeforeLabelEdit As LabelEditEventHandler
'Usage
Dim instance As ListView
Dim handler As LabelEditEventHandler

AddHandler instance.BeforeLabelEdit, handler

public event LabelEditEventHandler BeforeLabelEdit

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

/** @event */
public void add_BeforeLabelEdit (LabelEditEventHandler value)

/** @event */
public void remove_BeforeLabelEdit (LabelEditEventHandler value)

JScript unterstützt die Verwendung von Ereignissen, aber nicht die Deklaration von neuen Ereignissen.

Hinweise

Das BeforeLabelEdit-Ereignis tritt ein, wenn der Benutzer mit dem Ändern des Texts für ein Element beginnt. Wenn der Ereignishandler dieses Ereignis abbricht, kann der Benutzer den Text nicht bearbeiten. Sie können mithilfe dieses Ereignisses verhindern, dass Benutzer bestimmte Elemente im ListView-Steuerelement bearbeiten. Wenn die LabelEdit-Eigenschaft des ListView-Steuerelements auf false festgelegt ist, wird das BeforeLabelEdit-Ereignis nicht ausgelöst. In diesem Fall werden alle Versuche des Benutzers abgelehnt, Elementbezeichnungen zu bearbeiten.

Weitere Informationen zum Behandeln von Ereignissen finden Sie unter Behandeln von Ereignissen.

Beispiel

Im folgenden Codebeispiel werden die Behandlung des BeforeLabelEdit-Ereignisses und die Verwendung der LabelEditEventArgs.Item-Eigenschaft und der LabelEditEventArgs.CancelEdit-Eigenschaft veranschaulicht. Fügen Sie zum Ausführen des Beispiels folgenden Code in ein Formular ein, das das ListView-Steuerelement ListView1 mit mindestens drei Elementen enthält. Stellen Sie sicher, dass der Ereignishandler im Beispiel seinem Ereignis zugeordnet ist.

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

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

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.get_Item() < 2) {
        e.set_CancelEdit(true);
    }
} //listView1_BeforeLabelEdit

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

ListView-Klasse
ListView-Member
System.Windows.Forms-Namespace
OnBeforeLabelEdit
ListView.AfterLabelEdit-Ereignis
LabelEditEventHandler-Delegat
ListView.LabelEdit-Eigenschaft

Freigeben über