ListView.BeforeLabelEdit Evento

Definição

Ocorre quando o usuário começa a editar o rótulo de um item.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 

Exemplos

O exemplo de código a seguir demonstra como tratar o evento BeforeLabelEdit e usar as propriedades LabelEditEventArgs.Item e LabelEditEventArgs.CancelEdit.The following code example demonstrates handling the BeforeLabelEdit event and using the LabelEditEventArgs.Item and LabelEditEventArgs.CancelEdit properties. Para executar o exemplo, Cole o código a seguir em um formulário que contenha um controle de ListView chamado ListView1 e preenchido com pelo menos três itens.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. Verifique se o manipulador de eventos no exemplo está associado ao seu 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

Comentários

O evento BeforeLabelEdit ocorre quando o usuário começa a modificar o texto de um item.The BeforeLabelEdit event occurs when the user starts modifying the text for an item. Se o manipulador de eventos cancelar esse evento, o usuário não poderá editar o texto.If the event handler cancels this event, the user cannot edit the text. Você pode usar esse evento para impedir que o usuário edite itens específicos no controle de ListView.You can use this event to prevent the user from editing specific items in the ListView control. Se a propriedade LabelEdit do controle ListView for definida como false, o evento BeforeLabelEdit não será gerado; todos os usuários tentam editar rótulos de item são automaticamente rejeitados.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 obter mais informações sobre como manipular eventos, consulte manipulando e gerando eventos.For more information about handling events, see Handling and Raising Events.

Aplica-se a

Veja também