ListView.ColumnReordered Evento

Definição

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

Ocorre quando a ordem do cabeçalho da 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

ColumnReorderedEventHandler

Exemplos

O seguinte exemplo de código demonstra a utilização deste elemento. No exemplo, um gestor de eventos reporta a ocorrência do ColumnReordered evento. Este relatório ajuda-o a saber quando o evento ocorre e pode ajudá-lo na depuração. Para reportar múltiplos eventos ou eventos que ocorrem frequentemente, considere substituir MessageBox.Show ou Console.WriteLine anexar a mensagem a uma multilinha TextBox.

Para executar o código de exemplo, cole-o num projeto que contenha uma instância do tipo ListView chamada ListView1. Depois, certifique-se de que o gestor 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

Observações

O ColumnReordered evento é cancelável e pode ser cancelado ao gerir o evento e definir a Cancel propriedade para true. No entanto, se o evento for cancelado, o NewDisplayIndex de não ColumnReorderedEventArgs mudará para o OldDisplayIndex valor.

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

Aplica-se a