LabelEditEventArgs Classe

Definizione

Fornisce i dati per gli eventi BeforeLabelEdit e AfterLabelEdit.Provides data for the BeforeLabelEdit and AfterLabelEdit events.

public ref class LabelEditEventArgs : EventArgs
public class LabelEditEventArgs : EventArgs
type LabelEditEventArgs = class
    inherit EventArgs
Public Class LabelEditEventArgs
Inherits EventArgs
Ereditarietà
LabelEditEventArgs

Esempio

Nell'esempio di codice riportato di seguito viene illustrata la gestione dell'evento ListView.BeforeLabelEdit e l'utilizzo delle proprietà Item e CancelEdit.The following code example demonstrates handling the ListView.BeforeLabelEdit event and using the Item and CancelEdit properties. Per eseguire l'esempio, incollare il codice seguente in un modulo contenente un controllo ListView denominato ListView1 e popolato con almeno tre elementi.To run the example, paste the following code in a form containing a ListView control named ListView1 and populated with at least 3 items. Verificare che tutti gli eventi siano associati ai relativi metodi di gestione degli eventi.Ensure all events are associated with their event-handling methods.

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

Una LabelEditEventArgs specifica l'indice e la didascalia di un ListViewItem e la didascalia dopo che è stata modificata dall'utente.A LabelEditEventArgs specifies the index and caption of a ListViewItem and the caption after it has been edited by the user. Questa classe fornisce anche una proprietà CancelEdit.This class also provides a CancelEdit property. È possibile utilizzare questa proprietà in un gestore eventi ListView.BeforeLabelEdit per impedire all'utente di modificare l'etichetta.You can use this property in a ListView.BeforeLabelEdit event handler to prevent the user from editing the label. È anche possibile usarla in un gestore eventi ListView.AfterLabelEdit per annullare la modifica, restituendo l'etichetta al valore originale.You can also use it in an ListView.AfterLabelEdit event handler to revert the change, returning the label it to its original value. Questa operazione è utile quando si desidera convalidare l'input dell'utente prima di eseguire il commit della modifica.This is useful when you want to validate user input before committing the change.

Nota

Poiché l'evento ListView.AfterLabelEdit viene eseguito prima del commit della modifica dell'etichetta, chiamando il metodo ListView.Sort in un gestore per questo evento, l'elemento verrà ordinato usando il valore originale.Because the ListView.AfterLabelEdit event takes place before the label edit is committed, calling the ListView.Sort method in a handler for this event will sort the item using the original value.

Costruttori

LabelEditEventArgs(Int32)

Inizializza una nuova istanza della classe LabelEditEventArgs con l'indice specificato in corrispondenza dell'oggetto ListViewItem da modificare.Initializes a new instance of the LabelEditEventArgs class with the specified index to the ListViewItem to edit.

LabelEditEventArgs(Int32, String)

Inizializza una nuova istanza della classe LabelEditEventArgs con l'indice specificato in corrispondenza dell'oggetto ListViewItem da modificare e il nuovo testo dell'etichetta dell'oggetto ListViewItem.Initializes a new instance of the LabelEditEventArgs class with the specified index to the ListViewItem being edited and the new text for the label of the ListViewItem.

Proprietà

CancelEdit

Ottiene o imposta un valore che indica se devono essere annullate le modifiche apportate all'etichetta dell'oggetto ListViewItemGets or sets a value indicating whether changes made to the label of the ListViewItem should be canceled.

Item

Ottiene l'indice in base zero dell'oggetto ListViewItem che contiene l'etichetta da modificare.Gets the zero-based index of the ListViewItem containing the label to edit.

Label

Ottiene il nuovo testo assegnato all'etichetta dell'oggetto ListViewItem.Gets the new text assigned to the label of the ListViewItem.

Metodi

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)

Si applica a

Vedi anche