LabelEditEventArgs.CancelEdit Propriedade

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtém ou define um valor que indica se as alterações feitas ao rótulo do ListViewItem devem ser canceladas.

public:
 property bool CancelEdit { bool get(); void set(bool value); };

public bool CancelEdit { get; set; }

member this.CancelEdit : bool with get, set

Public Property CancelEdit As Boolean

Valor da propriedade

Boolean

true se a operação de edição do rótulo para o ListViewItem deve ser cancelada; caso contrário false, .

Exemplos

O exemplo de código a seguir demonstra como manipular o ListView.BeforeLabelEdit evento e usar as Item propriedades e CancelEdit . Para executar o exemplo, cole o código a seguir em um formulário que contém um controle ListView chamado ListView1 e preenchido com pelo menos 3 itens. Verifique se todos os eventos estão associados aos métodos de manipulação 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

Comentários

Você pode usar essa propriedade para cancelar as alterações feitas no rótulo de um ListViewItem e reverter-la ao texto original. Use essa propriedade para impedir que os legenda de um item sejam alterados para um valor que não atenda aos requisitos do aplicativo.