CListCtrl::SortItems
Classifica os itens de modo de exibição de lista usando uma função de comparação definido pelo aplicativo.
BOOL SortItems(
PFNLVCOMPARE pfnCompare,
DWORD_PTR dwData
);
Parâmetros
[in] pfnCompare
Endereço da função de comparação definido pelo aplicativo.A operação de classificar chama a função de comparação sempre que a ordem relativa de dois itens de lista precisa ser determinada.A função de comparação deve ser um membro estático de uma classe ou uma função independente que não é um membro de qualquer classe.
[in] dwData
Valor definido pelo aplicativo passado para a função de comparação.
Valor de retorno
true Se o método bem-sucedida; caso contrário false.
Comentários
Este método altera o índice de cada item para refletir a nova sequência.
A função de comparação, pfnCompare, possui a seguinte forma:
int CALLBACK CompareFunc(LPARAM lParam1, LPARAM lParam2, LPARAM lParamSort);
A função de comparação deve retornar um valor negativo se o primeiro item deve preceder o segundo, um valor positivo se o primeiro item deve seguir o segundo ou zero se os dois itens são iguais.
The lParam1 parâmetro é o valor de 32 bit associado com o primeiro item que é comparado com o lParam2 parâmetro é o valor associado com o segundo item. Estes são os valores especificados no lParam membro os itens LVITEM estrutura quando foram inseridos na lista.The lParamSort parâmetro for igual a dwData valor.
Esse método envia o LVM_SORTITEMS mensagem, que é descrita no Windows SDK.
Exemplo
A seguir é uma função de comparação simples que resultados em itens que estão sendo classificados por seus lParam valores.
// Sort items by associated lParam
int CALLBACK CListCtrlDlg::MyCompareProc(LPARAM lParam1, LPARAM lParam2,
LPARAM lParamSort)
{
UNREFERENCED_PARAMETER(lParamSort);
return (int)(lParam1 - lParam2);
}
Requisitos
Cabeçalho: afxcmn.h
Este controle tem suporte no Windows NT 3.51 ou posterior.