LabelEditEventArgs Classe

Definição

Espaço de Nomes:
System.Windows.Forms
Assemblagem:
System.Windows.Forms.dll

Fornece dados para os eventos BeforeLabelEdit e AfterLabelEdit.

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

Exemplos

O exemplo de código seguinte demonstra como lidar com o ListView.BeforeLabelEdit evento e usar as Item propriedades e.CancelEdit Para executar o exemplo, cole o código seguinte numa forma contendo um ListView controlo nomeado ListView1 e preenchido com pelo menos 3 itens. Assegure que todos os eventos estão associados aos seus métodos de gestã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

Observações

A LabelEditEventArgs especifica o índice e a legenda de a ListViewItem e a legenda após ter sido editada pelo utilizador. Esta classe também oferece uma CancelEdit propriedade. Pode usar esta propriedade num ListView.BeforeLabelEdit gestor de eventos para impedir que o utilizador edite o rótulo. Também pode usá-lo num ListView.AfterLabelEdit gestor de eventos para reverter a alteração, devolvendo o rótulo ao seu valor original. Isto é útil quando se quer validar a entrada do utilizador antes de comprometer a alteração.

Note

Como o ListView.AfterLabelEdit evento ocorre antes de a edição de etiqueta ser confirmada, chamar o ListView.Sort método num handler para este evento irá ordenar o item usando o valor original.

Construtores

Name Description
LabelEditEventArgs(Int32, String)

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

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

Propriedades

Name Description
CancelEdit

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

Obtém o índice em base zero do ListViewItem que contém a etiqueta para editar.
Label

Recebe o novo texto atribuído ao rótulo ListViewItemdo .

Métodos

Name Description
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Ver também