Freigeben über


ListView.BeforeLabelEdit Ereignis

Definition

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

public:
 event System::Windows::Forms::LabelEditEventHandler ^ BeforeLabelEdit;
public event System.Windows.Forms.LabelEditEventHandler BeforeLabelEdit;
public event System.Windows.Forms.LabelEditEventHandler? BeforeLabelEdit;
member this.BeforeLabelEdit : System.Windows.Forms.LabelEditEventHandler 
Public Custom Event BeforeLabelEdit As LabelEditEventHandler 

Ereignistyp

Beispiele

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

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

Das BeforeLabelEdit Ereignis tritt auf, wenn der Benutzer beginnt, den Text für ein Element zu ändern. Wenn der Ereignishandler dieses Ereignis abbricht, kann der Benutzer den Text nicht bearbeiten. Sie können dieses Ereignis verwenden, um zu verhindern, dass der Benutzer bestimmte Elemente im ListView Steuerelement bearbeitet. Wenn die LabelEdit -Eigenschaft des Steuerelements ListView auf falsefestgelegt ist, wird das BeforeLabelEdit Ereignis nicht ausgelöst. Alle Benutzerversuche, Elementbezeichnungen zu bearbeiten, werden automatisch abgelehnt.

Weitere Informationen zur Behandlung von Ereignissen finden Sie unter behandeln und Auslösen von Ereignissen.

Gilt für:

Weitere Informationen