LabelEditEventArgs.CancelEdit Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

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

public:
 property bool CancelEdit { bool get(); void set(bool value); };

public bool CancelEdit { get; set; }

member this.CancelEdit : bool with get, set

Public Property CancelEdit As Boolean

Eigenschaftswert

Boolean

true, wenn die Bearbeitung der Bezeichnung für ListViewItem verworfen werden soll, andernfalls false.

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

Sie können diese Eigenschaft verwenden, um Änderungen an der Bezeichnung eines ListViewItem abzubrechen und sie in den ursprünglichen Text zu rückgängig machen. Verwenden Sie diese Eigenschaft, um zu verhindern, dass die Untertitel eines Elements in einen Wert geändert wird, der die Anforderungen Ihrer Anwendung nicht erfüllt.