Partilhar via


ListView.ColumnReordered Evento

Definição

Ocorre quando a ordem de cabeçalho de coluna é alterada.

public:
 event System::Windows::Forms::ColumnReorderedEventHandler ^ ColumnReordered;
public event System.Windows.Forms.ColumnReorderedEventHandler ColumnReordered;
public event System.Windows.Forms.ColumnReorderedEventHandler? ColumnReordered;
member this.ColumnReordered : System.Windows.Forms.ColumnReorderedEventHandler 
Public Custom Event ColumnReordered As ColumnReorderedEventHandler 

Tipo de evento

Exemplos

O exemplo de código a seguir demonstra o uso desse membro. No exemplo, um manipulador de eventos relata a ocorrência do ColumnReordered evento. Este relatório ajuda você a saber quando o evento ocorre e pode ajudá-lo na depuração. Para relatar vários eventos ou eventos que ocorrem com frequência, considere substituir MessageBox.ShowConsole.WriteLine por ou acrescentar a mensagem a uma multilinha TextBox.

Para executar o código de exemplo, cole-o em um projeto que contém uma instância do tipo ListView chamada ListView1. Em seguida, verifique se o manipulador de eventos está associado ao ColumnReordered evento.

private void ListView1_ColumnReordered(Object sender, ColumnReorderedEventArgs e) {

System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "OldDisplayIndex", e.OldDisplayIndex );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "NewDisplayIndex", e.NewDisplayIndex );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "Header", e.Header );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "Cancel", e.Cancel );
messageBoxCS.AppendLine();
MessageBox.Show(messageBoxCS.ToString(), "ColumnReordered Event" );
}
Private Sub ListView1_ColumnReordered(sender as Object, e as ColumnReorderedEventArgs) _ 
     Handles ListView1.ColumnReordered

    Dim messageBoxVB as New System.Text.StringBuilder()
    messageBoxVB.AppendFormat("{0} = {1}", "OldDisplayIndex", e.OldDisplayIndex)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "NewDisplayIndex", e.NewDisplayIndex)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "Header", e.Header)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "Cancel", e.Cancel)
    messageBoxVB.AppendLine()
    MessageBox.Show(messageBoxVB.ToString(),"ColumnReordered Event")

End Sub

Comentários

O ColumnReordered evento é um evento cancelável e pode ser cancelado manipulando o evento e definindo a Cancel propriedade truecomo . No entanto, se o evento for cancelado, o NewDisplayIndexColumnReorderedEventArgs do não será alterado para o OldDisplayIndex valor .

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

Aplica-se a