CListCtrl::SortItems

Artigo
08/25/2010

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);
}