Freigeben über

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 Eigenschaften und 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 mit mindestens 3 Elementen aufgefüllt ist. 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 Untertitel eines ListViewItem und der Untertitel an, nachdem sie vom Benutzer bearbeitet wurden. Diese Klasse stellt auch eine Eigenschaft bereit CancelEdit . Sie können diese Eigenschaft in einem ListView.BeforeLabelEdit Ereignishandler verwenden, um zu verhindern, dass der Benutzer die Bezeichnung bearbeitet. Sie können sie auch in einem ListView.AfterLabelEdit Ereignishandler verwenden, um die Änderung zu rückgängig machen und die Bezeichnung auf den ursprünglichen Wert zurückzugeben. Dies ist nützlich, wenn Sie die Benutzereingabe überprüfen möchten, bevor Sie die Änderung committen.

Hinweis

Da das ListView.AfterLabelEdit Ereignis vor dem Commit für die Bezeichnungsbearbeitung stattfindet, wird das Element beim Aufrufen der ListView.Sort Methode in einem Handler für dieses Ereignis mithilfe des ursprünglichen Werts sortiert.

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:

Weitere Informationen