LabelEditEventArgs Clase

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Proporciona datos para los eventos BeforeLabelEdit y AfterLabelEdit.

public ref class LabelEditEventArgs : EventArgs

public class LabelEditEventArgs : EventArgs

type LabelEditEventArgs = class
    inherit EventArgs

Public Class LabelEditEventArgs
Inherits EventArgs

Herencia

Object

EventArgs

LabelEditEventArgs

Ejemplos

En el ejemplo de código siguiente se muestra cómo controlar el ListView.BeforeLabelEdit evento y usar las Item propiedades y CancelEdit . Para ejecutar el ejemplo, pegue el código siguiente en un formulario que contiene un ListView control denominado ListView1 y rellenado con al menos 3 elementos. Asegúrese de que todos los eventos están asociados a sus métodos de control de eventos.

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 objeto especifica el índice y subtítulo de y ListViewItem la subtítulo después de que el usuario la haya editado. Esta clase también proporciona una CancelEdit propiedad . Puede usar esta propiedad en un ListView.BeforeLabelEdit controlador de eventos para impedir que el usuario edite la etiqueta. También puede usarlo en un ListView.AfterLabelEdit controlador de eventos para revertir el cambio, devolviendo la etiqueta a su valor original. Esto resulta útil cuando desea validar la entrada del usuario antes de confirmar el cambio.

Nota

Dado que el ListView.AfterLabelEdit evento tiene lugar antes de confirmar la edición de etiquetas, al llamar al ListView.Sort método en un controlador para este evento se ordenará el elemento con el valor original.

Constructores

LabelEditEventArgs(Int32)	Inicializa una nueva instancia de la clase LabelEditEventArgs con el índice especificado en el ListViewItem que se va a editar.
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.

Propiedades

CancelEdit	Obtiene o establece un valor que indica si los cambios realizados en la etiqueta de ListViewItem deben cancelarse.
Item	Obtiene el índice de base cero de ListViewItem, que contiene la etiqueta que se va a editar.
Label	Obtiene el nuevo texto asignado a la etiqueta de ListViewItem.

Métodos

Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Consulte también

• ListView
• ListViewItem
• BeforeLabelEdit
• AfterLabelEdit