LabelEditEventArgs.CancelEdit Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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, setPublic Property CancelEdit As BooleanEigenschaftswert
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.
