ListView.BeforeLabelEdit Event

Definition

Si verifica quando l'utente inizia a modificare l'etichetta di un elemento.Occurs when the user starts editing the label of an item.

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 

Examples

Nell'esempio di codice riportato di seguito viene illustrata la gestione dell'evento BeforeLabelEdit e l'utilizzo delle proprietà LabelEditEventArgs.Item e LabelEditEventArgs.CancelEdit.The following code example demonstrates handling the BeforeLabelEdit event and using the LabelEditEventArgs.Item and LabelEditEventArgs.CancelEdit properties. Per eseguire l'esempio, incollare il codice seguente in un modulo che contiene un controllo ListView denominato ListView1 e popolato con almeno tre elementi.To run the example, paste the following code into a form that contains a ListView control named ListView1 and populated with at least three items. Verificare che il gestore eventi nell'esempio sia associato al relativo evento.Ensure the event handler in the example is associated with its event.

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

Remarks

L'evento BeforeLabelEdit si verifica quando l'utente inizia a modificare il testo di un elemento.The BeforeLabelEdit event occurs when the user starts modifying the text for an item. Se il gestore dell'evento annulla questo evento, l'utente non può modificare il testo.If the event handler cancels this event, the user cannot edit the text. È possibile utilizzare questo evento per impedire all'utente di modificare elementi specifici nel controllo ListView.You can use this event to prevent the user from editing specific items in the ListView control. Se la proprietà LabelEdit del controllo ListView è impostata su false, l'evento BeforeLabelEdit non viene generato. tutti i tentativi utente di modificare le etichette degli elementi vengono rifiutati automaticamente.If the LabelEdit property of the ListView control is set to false, the BeforeLabelEdit event is not raised; all user attempts to edit item labels are automatically rejected.

Per ulteriori informazioni sulla gestione degli eventi, consultare gestione e generazione di eventi.For more information about handling events, see Handling and Raising Events.

Applies to

See also