Evento ListView.BeforeLabelEdit (System.Windows.Forms)

L'evento BeforeLabelEdit si verifica quando l'utente inizia a modificare il testo di un elemento. Se l'evento viene annullato dal gestore eventi, l'utente non può modificare il testo. È possibile utilizzare questo evento per impedire all'utente di modificare elementi specifici all'interno del controllo ListView. Se la proprietà LabelEdit del controllo ListView è impostata su false, l'evento BeforeLabelEdit non viene generato e tutti i tentativi dell'utente di modificare le etichette degli elementi vengono automaticamente rifiutati.

Per ulteriori informazioni sulla gestione di eventi, vedere Utilizzo degli eventi.

Nell'esempio di codice riportato di seguito viene illustrato come gestire l'evento BeforeLabelEdit e come utilizzare le proprietà LabelEditEventArgs.Item e LabelEditEventArgs.CancelEdit. Per eseguire l'esempio, incollare il codice riportato di seguito in un form contenente un controllo ListView di nome ListView1 compilato con almeno tre elementi. Assicurarsi che il gestore eventi nell'esempio sia associato ai relativi eventi.

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

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

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema.

.NET Framework