ListView.BeforeLabelEdit Evento

Definición

Se produce cuando el usuario empieza a editar la etiqueta de un elemento.Occurs when the user starts editing the label of an item.

public:
 event System::Windows::Forms::LabelEditEventHandler ^ BeforeLabelEdit;
public event System.Windows.Forms.LabelEditEventHandler BeforeLabelEdit;
member this.BeforeLabelEdit : System.Windows.Forms.LabelEditEventHandler 
Public Custom Event BeforeLabelEdit As LabelEditEventHandler 

Ejemplos

En el ejemplo de código siguiente se muestra el control del evento BeforeLabelEdit y el uso de las propiedades LabelEditEventArgs.Item y LabelEditEventArgs.CancelEdit.The following code example demonstrates handling the BeforeLabelEdit event and using the LabelEditEventArgs.Item and LabelEditEventArgs.CancelEdit properties. Para ejecutar el ejemplo, pegue el código siguiente en un formulario que contenga un control ListView denominado ListView1 y rellenado con al menos tres elementos.To run the example, paste the following code into a form that contains a ListView control named ListView1 and populated with at least three items. Asegúrese de que el controlador de eventos del ejemplo está asociado a su evento.Ensure the event handler in the example is associated with its event.

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

El evento BeforeLabelEdit se produce cuando el usuario comienza a modificar el texto de un elemento.The BeforeLabelEdit event occurs when the user starts modifying the text for an item. Si el controlador de eventos cancela este evento, el usuario no puede modificar el texto.If the event handler cancels this event, the user cannot edit the text. Puede usar este evento para impedir que el usuario modifique elementos específicos en el control ListView.You can use this event to prevent the user from editing specific items in the ListView control. Si la propiedad LabelEdit del control ListView está establecida en false, no se produce el evento BeforeLabelEdit; todos los intentos de usuario para editar etiquetas de elementos se rechazan automáticamente.If the LabelEdit property of the ListView control is set to false, the BeforeLabelEdit event is not raised; all user attempts to edit item labels are automatically rejected.

Para obtener más información sobre el manejo de eventos, consulte controlar y provocar eventos.For more information about handling events, see Handling and Raising Events.

Se aplica a

Consulte también: