Partilhar via


LabelEditEventArgs Classe

Definição

Fornece dados para os eventos de BeforeLabelEdit e de AfterLabelEdit .

public ref class LabelEditEventArgs : EventArgs
public class LabelEditEventArgs : EventArgs
type LabelEditEventArgs = class
    inherit EventArgs
Public Class LabelEditEventArgs
Inherits EventArgs
Herança
LabelEditEventArgs

Exemplos

O exemplo de código a seguir demonstra o tratamento do ListView.BeforeLabelEdit evento e o uso das Item propriedades e 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 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

Um LabelEditEventArgs especifica o índice e o legenda de um ListViewItem e o legenda depois de ter sido editado pelo usuário. Essa classe também fornece uma CancelEdit propriedade . Você pode usar essa propriedade em um ListView.BeforeLabelEdit manipulador de eventos para impedir que o usuário edite o rótulo. Você também pode usá-lo em um ListView.AfterLabelEdit manipulador de eventos para reverter a alteração, retornando o rótulo para seu valor original. Isso é útil quando você deseja validar a entrada do usuário antes de confirmar a alteração.

Observação

Como o ListView.AfterLabelEdit evento ocorre antes da edição do rótulo ser confirmada, chamar o ListView.Sort método em um manipulador para esse evento classificará o item usando o valor original.

Construtores

LabelEditEventArgs(Int32)

Inicializa uma nova instância da classe LabelEditEventArgs com o índice especificado para o ListViewItem a ser editado.

LabelEditEventArgs(Int32, String)

Inicializa uma nova instância da classe LabelEditEventArgs com o índice especificado para o ListViewItem que está sendo editado e o novo texto do rótulo do ListViewItem.

Propriedades

CancelEdit

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

Item

Obtém o índice de base zero do ListViewItem que contém o rótulo a ser editado.

Label

Obtém o novo texto atribuído ao rótulo do ListViewItem.

Métodos

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Confira também