LabelEditEventArgs Clase

Definición

Proporciona datos para los eventos BeforeLabelEdit y 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
Herencia
LabelEditEventArgs

Ejemplos

En el ejemplo de código siguiente se ListView.BeforeLabelEdit muestra cómo controlar el Item evento CancelEdit y usar las propiedades y.The following code example demonstrates handling the ListView.BeforeLabelEdit event and using the Item and CancelEdit properties. Para ejecutar el ejemplo, pegue el código siguiente en un formulario que contenga ListView un ListView1 control denominado y rellenado con al menos 3 elementos.To run the example, paste the following code in a form containing a ListView control named ListView1 and populated with at least 3 items. Asegúrese de que todos los eventos estén asociados a sus métodos de control de eventos.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

Comentarios

Un LabelEditEventArgs especifica el índice y el título de ListViewItem un y el título una vez editado por el usuario.A LabelEditEventArgs specifies the index and caption of a ListViewItem and the caption after it has been edited by the user. Esta clase también proporciona una CancelEdit propiedad.This class also provides a CancelEdit property. Puede usar esta propiedad en un ListView.BeforeLabelEdit controlador de eventos para evitar que el usuario edite la etiqueta.You can use this property in a ListView.BeforeLabelEdit event handler to prevent the user from editing the label. También puede utilizarlo en un ListView.AfterLabelEdit controlador de eventos para revertir el cambio y devolver la etiqueta a su valor original.You can also use it in an ListView.AfterLabelEdit event handler to revert the change, returning the label it to its original value. Esto resulta útil si desea validar los datos proporcionados por el usuario antes de confirmar el cambio.This is useful when you want to validate user input before committing the change.

Nota

Dado que ListView.AfterLabelEdit el evento tiene lugar antes de que se confirme la edición de ListView.Sort la etiqueta, al llamar al método en un controlador para este evento se ordenará el elemento con el valor original.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.

Constructores

LabelEditEventArgs(Int32)

Inicializa una nueva instancia de la clase LabelEditEventArgs con el índice especificado en el ListViewItem que se va a editar.Initializes a new instance of the LabelEditEventArgs class with the specified index to the ListViewItem to edit.

LabelEditEventArgs(Int32, String)

Inicializa una nueva instancia de la clase LabelEditEventArgs con el índice especificado en el ListViewItem que está editando y el nuevo texto para la etiqueta de 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.

Propiedades

CancelEdit

Obtiene o establece un valor que indica si los cambios realizados en la etiqueta de ListViewItem deben cancelarse.Gets or sets a value indicating whether changes made to the label of the ListViewItem should be canceled.

Item

Obtiene el índice de base cero de ListViewItem, que contiene la etiqueta que se va a editar.Gets the zero-based index of the ListViewItem containing the label to edit.

Label

Obtiene el nuevo texto asignado a la etiqueta de ListViewItem.Gets the new text assigned to the label of the ListViewItem.

Métodos

Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
GetHashCode()

Sirve como función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
ToString()

Devuelve un valor de tipo string que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)

Se aplica a

Consulte también: