LabelEditEventArgs Klasse

  • Referenz

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

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

public ref class LabelEditEventArgs : EventArgs
public class LabelEditEventArgs : EventArgs
type LabelEditEventArgs = class
    inherit EventArgs
Public Class LabelEditEventArgs
Inherits EventArgs
Vererbung
Object
EventArgs
LabelEditEventArgs

Beispiele

Im folgenden Codebeispiel wird die Behandlung des Ereignisses ListView.BeforeLabelEdit und die Verwendung der Item Und-Eigenschaften CancelEdit veranschaulicht. Fügen Sie zum Ausführen des Beispiels den folgenden Code in ein Formular ein, das ein ListView Steuerelement mit dem Namen ListView1 enthält und mindestens 3 Elemente enthält. Stellen Sie sicher, dass alle Ereignisse ihren Ereignisbehandlungsmethoden zugeordnet sind.

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

Hinweise

A LabelEditEventArgs gibt den Index und die Beschriftung einer ListViewItem und der Beschriftung an, nachdem sie vom Benutzer bearbeitet wurde. Diese Klasse stellt auch eine CancelEdit Eigenschaft bereit. Sie können diese Eigenschaft in einem ListView.BeforeLabelEdit Ereignishandler verwenden, um zu verhindern, dass der Benutzer die Bezeichnung bearbeitet. Sie können es auch in einem ListView.AfterLabelEdit Ereignishandler verwenden, um die Änderung zurückzugeben und die Bezeichnung an den ursprünglichen Wert zurückzugeben. Dies ist nützlich, wenn Sie die Benutzereingabe überprüfen möchten, bevor Sie die Änderung übernehmen.

Hinweis

Da das ListView.AfterLabelEdit Ereignis stattfindet, bevor die Bezeichnungsbearbeitung ausgeführt wird, sortiert das Ereignis durch Aufrufen der ListView.Sort Methode in einem Handler für dieses Ereignis das Element mithilfe des ursprünglichen Werts.

Konstruktoren

LabelEditEventArgs(Int32)

Initialisiert eine neue Instanz der LabelEditEventArgs-Klasse mit dem angegebenen Index des zu bearbeitenden ListViewItem.
LabelEditEventArgs(Int32, String)

Initialisiert eine neue Instanz der LabelEditEventArgs-Klasse mit dem angegebenen Index des derzeit bearbeiteten ListViewItem und dem neuen Text für die Bezeichnung von ListViewItem.

Eigenschaften

CancelEdit

Ruft einen Wert ab, der angibt, ob die an der Bezeichnung von ListViewItem vorgenommenen Änderungen verworfen werden sollen, oder legt diesen fest.
Item

Ruft den nullbasierten Index des ListViewItem ab, das die zu bearbeitende Bezeichnung enthält.
Label

Ruft den neuen Text ab, der der Bezeichnung von ListViewItem zugewiesen wird.

Methoden

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Gilt für:

Siehe auch