ListView.BeforeLabelEdit Evento

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

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

Tipo de evento

LabelEditEventHandler

Exemplos

O exemplo de código a seguir demonstra como manipular o BeforeLabelEdit evento e usar as LabelEditEventArgs.Item propriedades e LabelEditEventArgs.CancelEdit . Para executar o exemplo, cole o código a seguir em um formulário que contém um ListView controle chamado ListView1 e preenchido com pelo menos três itens. Verifique se o manipulador de eventos no exemplo está associado ao seu evento.

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 BeforeLabelEdit evento ocorre quando o usuário começa a modificar o texto de um item. Se o manipulador de eventos cancelar esse evento, o usuário não poderá editar o texto. Você pode usar esse evento para impedir que o usuário edite itens específicos no ListView controle. Se a LabelEdit propriedade do controle estiver definida como false, o BeforeLabelEdit evento não será gerado; todas as tentativas do ListView usuário de editar rótulos de itens serão rejeitadas automaticamente.

Para obter mais informações sobre como lidar com eventos, consulte Manipulando e gerando eventos.

Confira também

• OnBeforeLabelEdit(LabelEditEventArgs)
• AfterLabelEdit
• LabelEditEventHandler
• LabelEdit