Como ordenar itens numa CListCtrl na vista de relatório

Não é a quantidade de informações forneceu para o processo de ordenar itens num controlo ListView, especialmente um moldado pela classe CListCtrl MFC. Os detalhes são fáceis de implementar e este artigo tenta preencher o intervalo na documentação para esta funcionalidade útil. O código de exemplo representa uma caixa de diálogo de MFC com um controlo de lista definido para o estilo LVS_REPORT.

Para ordenar os itens num controlo ListView, tem de existir uma estrutura LVITEM associada ao produto. MFC fornece este para o programador, permitindo que um item a ser inserida através de uma chamada de função InsertItem(int nItem, LPCTSTR lpszItem) simples que cria a estrutura com predefinições razoáveis. Por vezes, pode ser enganadora tal uma memória intermédia de complexidade subjacente. No entanto, a estrutura LVITEM é uma chave importante para manipulação de itens ListView, incluindo o mecanismo de ordenação.

O elemento lParam LVITEM fornece informações necessárias. Quando a função SortItems classe CListCtrl é chamada, tem de fornecer um apontador de função para uma função de chamada de retorno de ordenação e um valor DWORD definidas pela aplicação. Durante a ordenação, a função de chamada de retorno repetidamente é invocada como dois itens do controlo de lista são seleccionados para comparação. Os parâmetros que recebe são o elemento lParam de LVITEM estrutura cada item e o valor DWORD transmitido pela chamada SortItems .

O código abaixo representa um exemplo simples de ordenar uma lista dos dez dos Estados Unidos CEOs num controlo ListView. Os CEOs inicialmente são armazenados numa matriz CString multidimensional estática.


A função de ordenação de chamada de retorno pode estar definida estaticamente como um membro de uma classe ou, como aqui apenas como uma função global:

O elemento lParam pode ser qualquer coisa desde simples para muito complexos. Frequentemente, uma estrutura é útil neste contexto, permitindo várias partes de dados a ser referenciada. Neste exemplo, uma estrutura chamada ITEMDATA foi definida para manter os três elementos que compõem um determinado item:

Neste exemplo, a estrutura tiver sido definida no ficheiro de cabeçalho de uma classe CDialog , pelo que foi definida uma variável de membro de um ponteiro para uma matriz de 10:

Um controlo ListView foi adicionado a uma caixa de diálogo e uma variável de membro definida chamado m_ctlListView. Os itens foram adicionados no OnInitDialog :


Foram inseridas três colunas para o último nome, nome próprio e termo do escritório. Em seguida, para cada um dos dez itens, uma nova estrutura ITEMDATA está atribuída e inicializada da matriz CString. O produto é inserido muito simples, utilizando apenas o índice e a última cadeia do nome, em seguida, o texto está definido para as outras duas colunas do produto. Finalmente, a função SetItemData é chamado, passando ITEMDATA novo como um parâmetro. Isto reinicializa lParam da estrutura LVITEM do produto e prepara a forma para a ordenação.

MFC no Visual C++ 6.0 tem um problema com as notificações de cabeçalho para o controlo de ListView. Apesar de uma rotina de tratamento pode ser adicionada, na versão actual esta não é chamada. Por exemplo, utilize o Assistente de classe ou o WizardBar para adicionar um processador de mensagens do Windows. Se o ID de Controlo ListView estiver realçado, um número de mensagens de notificação está disponível para selecção. Para ordenar os itens quando o cabeçalho é clicado para uma determinada coluna, seleccione a notificação HDN_ITEMCLICK . Uma entrada de mapa de mensagem ON_NOTIFY é gerada, bem como uma função do processador. Por exemplo actual, aparece a entrada da seguinte forma:


Aqui o problema é que a notificação não realmente provêm do controlo ListView; em vez disso, o controlo de cabeçalho criado por ListView envia a notificação. A entrada de mapa de mensagem listada acima não funciona. A correcção é simples, no entanto, uma vez que o controlo de cabeçalho tem sempre um ID de 0, a macro pode ser editada para funcionar correctamente:

Em seguida, no processador de OnItemclickList1, é efectuada a chamada SortItems :

O cabeçalho de mensagem de notificação ( NMHDR ) é realmente uma notificação ListView, NMLISTVIEW , que contém o índice para a coluna que foi clicado. Neste exemplo, isto é representado por iItem . Listas mais complexas ser necessário referenciar o elemento iSubItem desta estrutura bem. O endereço da função de chamada de retorno é transmitido ao SortItems , juntamente com o número da coluna que foi clicado.

A rotina SortFunc é designado por repetidamente como pares de itens a ListView são transmitidos para a função de comparação. Os primeiros dois parâmetros são o elemento lParam da estrutura LVITEM dos respectivos itens e o terceiro parâmetro (definidas pelo aplicação) é o número de coluna fornecido na chamada SortItems .

O índice de coluna transmitido lParamSort determina o elemento de objectos ITEMDATA transmitido lParam1 e lParam2 deve ser utilizado para comparação. O resultado é devolvido e o processo continua até tem sido ordenados todos os itens.

Como um lembrete, as estruturas ITEMDATA que foram atribuídas os itens da lista tem de eventualmente ser destruído. Neste exemplo, o processador WM_DESTROY a caixa de diálogo itera através dos elementos membro e elimina-os.

Para mais informações no controlo ListView comuns, consulte a documentação do Platform SDK em Controlos comuns do Windows na secção Serviços de interface de utilizador .