LabelEditEventArgs Classe

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origine:

LabelEditEventArgs.cs

Fornisce dati per gli eventi BeforeLabelEdit e AfterLabelEdit.

public ref class LabelEditEventArgs : EventArgs

public class LabelEditEventArgs : EventArgs

type LabelEditEventArgs = class
    inherit EventArgs

Public Class LabelEditEventArgs
Inherits EventArgs

Ereditarietà

Object

EventArgs

LabelEditEventArgs

Esempio

Nell'esempio di codice seguente viene illustrata la gestione dell'evento e l'uso ListView.BeforeLabelEdit delle Item proprietà e CancelEdit . Per eseguire l'esempio, incollare il codice seguente in una maschera contenente un ListView controllo denominato ListView1 e popolato con almeno 3 elementi. Verificare che tutti gli eventi siano associati ai metodi di gestione degli eventi.

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

Commenti

Specifica LabelEditEventArgs l'indice e la didascalia di un ListViewItem oggetto e la didascalia dopo che è stata modificata dall'utente. Questa classe fornisce anche una CancelEdit proprietà . È possibile utilizzare questa proprietà in un ListView.BeforeLabelEdit gestore eventi per impedire all'utente di modificare l'etichetta. È anche possibile usarlo in un ListView.AfterLabelEdit gestore eventi per ripristinare la modifica, restituendo l'etichetta al valore originale. Ciò è utile quando si vuole convalidare l'input dell'utente prima di eseguire il commit della modifica.

Annotazioni

Poiché l'evento viene eseguito prima del ListView.AfterLabelEdit commit della modifica dell'etichetta, la chiamata al ListView.Sort metodo in un gestore per questo evento ordina l'elemento usando il valore originale.

Costruttori

Nome	Descrizione
LabelEditEventArgs(Int32, String)	Inizializza una nuova istanza della LabelEditEventArgs classe con l'indice specificato per l'oggetto ListViewItem modificato e il nuovo testo per l'etichetta dell'oggetto ListViewItem.
LabelEditEventArgs(Int32)	Inizializza una nuova istanza della LabelEditEventArgs classe con l'indice specificato all'oggetto ListViewItem da modificare.

Proprietà

Nome	Descrizione
CancelEdit	Ottiene o imposta un valore che indica se le modifiche apportate all'etichetta dell'oggetto ListViewItem devono essere annullate.
Item	Ottiene l'indice in base zero dell'oggetto ListViewItem contenente l'etichetta da modificare.
Label	Ottiene il nuovo testo assegnato all'etichetta dell'oggetto ListViewItem.

Vedi anche

• ListView
• ListViewItem
• BeforeLabelEdit
• AfterLabelEdit