LabelEditEventArgs-Klasse

Artikel
08/20/2007

Stellt Daten für das ListView.BeforeLabelEdit-Ereignis und das ListView.AfterLabelEdit-Ereignis bereit.

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

Syntax

'Declaration
Public Class LabelEditEventArgs
    Inherits EventArgs
'Usage
Dim instance As LabelEditEventArgs

public class LabelEditEventArgs : EventArgs

public ref class LabelEditEventArgs : public EventArgs

public class LabelEditEventArgs extends EventArgs

public class LabelEditEventArgs extends EventArgs

Hinweise

LabelEditEventArgs gibt den Index und die Beschriftung von ListViewItem sowie die Beschriftung nach Bearbeitung durch den Benutzer an. Diese Klasse stellt auch eine CancelEdit-Eigenschaft bereit. Sie können diese Eigenschaft in einem ListView.BeforeLabelEdit-Ereignishandler verwenden, um eine Bearbeitung der Beschriftung durch den Benutzer zu verhindern. Außerdem können Sie sie in einem ListView.AfterLabelEdit-Ereignishandler verwenden, um die Änderung zu verwerfen und die Beschriftung auf den ursprünglichen Wert zurückzusetzen. Dies ist dann nützlich, wenn Sie die Benutzereingabe vor dem Ausführen eines Commits der Änderung überprüfen möchten.

Hinweis

Da das ListView.AfterLabelEdit-Ereignis vor dem Commit der Beschriftungsbearbeitung ausgeführt wird, wird das Element anhand seines ursprünglichen Werts sortiert, wenn Sie die ListView.Sort-Methode in einem Handler aufrufen.

Beispiel

Im folgenden Codebeispiel wird die Behandlung des ListView.BeforeLabelEdit-Ereignisses und die Verwendung der Item-Eigenschaft und der CancelEdit-Eigenschaft veranschaulicht. Fügen Sie zum Ausführen des Beispiels folgenden Code in ein Formular ein, das ein ListView-Steuerelement mit dem Namen ListView1 mit mindestens drei Elementen enthält. Stellen Sie sicher, dass allen Ereignissen eine entsprechende Methode für die Ereignisbehandlung 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

Vererbungshierarchie

System.Object
System.EventArgs
System.Windows.Forms.LabelEditEventArgs

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

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

LabelEditEventArgs-Member
System.Windows.Forms-Namespace
ListView
ListViewItem
ListView.BeforeLabelEdit
ListView.AfterLabelEdit

Freigeben über