macro ListView_SortItems (commctrl.h)
Usa uma função de comparação definida pelo aplicativo para classificar os itens de um controle de exibição de lista. O índice de cada item é alterado para refletir a nova sequência. Você pode usar essa macro ou enviar a mensagem LVM_SORTITEMS explicitamente.
Sintaxe
void ListView_SortItems(
hwndLV,
_pfnCompare,
_lPrm
);
Parâmetros
hwndLV
Tipo: HWND
Um identificador para o controle de exibição de lista.
_pfnCompare
Tipo: PFNLVCOMPARE
Um ponteiro para a função de comparação definida pelo aplicativo. A função de comparação é chamada durante a operação de classificação sempre que a ordem relativa de dois itens de lista precisa ser comparada.
_lPrm
Tipo: LPARAM
O valor definido pelo aplicativo que é passado para a função de comparação.
Retornar valor
Nenhum
Comentários
A função de comparação tem o seguinte formato.
int CALLBACK CompareFunc(LPARAM lParam1, LPARAM lParam2, LPARAM lParamSort);
O parâmetro lParam1 é o valor associado ao primeiro item que está sendo comparado; e o parâmetro lParam2 é o valor associado ao segundo item. Esses são os valores especificados no membro lParam da estrutura LVITEM dos itens quando foram inseridos na lista. O parâmetro lParamSort é o mesmo valor passado para a mensagem LVM_SORTITEMS .
A função de comparação deverá 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 forem equivalentes.
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Windows Vista [somente aplicativos da área de trabalho] |
Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
Plataforma de Destino | Windows |
Cabeçalho | commctrl.h |