CListCtrl::SortItems
Itens de exibição de lista de tipos usando uma função application-defined de comparação.
BOOL SortItems(
PFNLVCOMPARE pfnCompare,
DWORD_PTR dwData
);
Parâmetros
[in] pfnCompare
Endereço de função application-defined de comparação.A operação de tipo chama a função de comparação cada vez que o pedido relativo de dois itens de lista precisa ser determinado.A função de comparação deve ser um membro estático de uma classe ou uma função autônomo que não seja um membro de nenhuma classe.
[in] dwData
Valor definido que é passado para a função de comparação.
Valor de retorno
true se o método com êxito; se não false.
Comentários
Este método altera o índice de cada item para refletir a nova seqüência.
A função de comparação, pfnCompare, tem 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 preceder o segundo, um valor positivo se o primeiro item e o segundo, ou zera se os dois itens são iguais.
o parâmetro de lParam1 é o valor de 32 bits associado com o primeiro item que é comparado, e o parâmetro de lParam2 é o valor associado com o segundo item.Estes são os valores que foram especificados em lParam membro de estrutura de LVITEM de itens quando foram inseridos na lista.o parâmetro de lParamSort é o mesmo que o valor de dwData .
Este método envia a mensagem de LVM_SORTITEMS , que é descrita em Windows SDK.
Exemplo
O exemplo a seguir é uma função simples de comparação que resulta nos itens que estão sendo classificados por seus valores de lParam .
// Sort items by associated lParam
int CALLBACK CListCtrlDlg::MyCompareProc(LPARAM lParam1, LPARAM lParam2,
LPARAM lParamSort)
{
UNREFERENCED_PARAMETER(lParamSort);
return (int)(lParam1 - lParam2);
}
// Sort the items by passing in the comparison function.
void CListCtrlDlg::Sort()
{
m_myListCtrl.SortItems(&CListCtrlDlg::MyCompareProc, 0);
}
Requisitos
Cabeçalho: afxcmn.h
Esse controle é suportado no Windows NT 3,51 ou posterior.