LabelEditEventArgs Clase

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Source:

LabelEditEventArgs.cs

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

especifica LabelEditEventArgs el índice y el título de un ListViewItem y el título después de que el usuario lo haya editado. Esta clase también proporciona una CancelEdit propiedad . Puede usar esta propiedad en un ListView.BeforeLabelEdit controlador de eventos para evitar 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, llamar al ListView.Sort método en un controlador para este evento ordenará el elemento con el valor original.

Constructores

Nombre	Description
LabelEditEventArgs(Int32, String)	Inicializa una nueva instancia de la LabelEditEventArgs clase con el índice especificado en el ListViewItem objeto que se está editando y el nuevo texto de la etiqueta de ListViewItem.
LabelEditEventArgs(Int32)	Inicializa una nueva instancia de la LabelEditEventArgs clase con el índice especificado en el ListViewItem que se va a editar.

Propiedades

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

Consulte también

• ListView
• ListViewItem
• BeforeLabelEdit
• AfterLabelEdit