LabelEditEventArgs.CancelEdit-Eigenschaft

Artikel
08/20/2007

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

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Public Property CancelEdit As Boolean
'Usage
Dim instance As LabelEditEventArgs
Dim value As Boolean

value = instance.CancelEdit

instance.CancelEdit = value

public bool CancelEdit { get; set; }

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

/** @property */
public boolean get_CancelEdit ()

/** @property */
public void set_CancelEdit (boolean value)

public function get CancelEdit () : boolean

public function set CancelEdit (value : boolean)

Eigenschaftenwert

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

Hinweise

Mit dieser Eigenschaft können die Änderungen der Bezeichnung von ListViewItem verworfen und der ursprüngliche Text wiederhergestellt werden. Mithilfe dieser Eigenschaft können Sie verhindern, dass die Beschriftung eines Elements entgegen den Erfordernissen der Anwendung geändert wird.

Beispiel

Im folgenden Codebeispiel wird die Behandlung des ListView.BeforeLabelEdit-Ereignisses und die Verwendung der Item-Eigenschaft und der CancelEdit-Eigenschaft veranschaulicht. Fügen Sie zum Ausführen des Beispiels folgenden Code in ein Formular ein, das ein ListView-Steuerelement mit dem Namen ListView1 mit mindestens drei Elementen enthält. Stellen Sie sicher, dass allen Ereignissen eine entsprechende Methode für die Ereignisbehandlung zugeordnet ist.

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

   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;
    }
}

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.get_Item() < 2) {
        e.set_CancelEdit(true);
    }
} //listView1_BeforeLabelEdit

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

LabelEditEventArgs-Klasse
LabelEditEventArgs-Member
System.Windows.Forms-Namespace

Freigeben über