LVM_SORTITEMSEX mensagem

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 enviar essa mensagem explicitamente ou usando a macro ListView_SortItemsEx .

Parâmetros

wParam

Valor definido pelo aplicativo que é passado para a função de comparação.

lParam

Ponteiro para uma função de comparação definida pelo aplicativo. Ele é chamado durante a operação de classificação sempre que a ordem relativa de dois itens de lista precisa ser comparada.

Valor retornado

Retorna TRUE se tiver êxito ou FALSE caso contrário.

Comentários

A função de comparação tem o seguinte formulário:

int CALLBACK CompareFunc(LPARAM lParam1, LPARAM lParam2, LPARAM lParamSort);  

Essa mensagem é semelhante a LVM_SORTITEMS, exceto pelo tipo de informações passadas para a função de comparação. Com LVM_SORTITEMSEX, lParam1 é o índice atual do primeiro item e lParam2 é o índice atual do segundo item. Você pode enviar uma mensagem LVM_GETITEMTEXT para recuperar mais informações sobre um item, se necessário.

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.

Observação

Durante o processo de classificação, o conteúdo de exibição de lista é instável. Se a função de retorno de chamada enviar mensagens para o controle de exibição de lista além de LVM_GETITEM (ListView_GetItem), os resultados serão imprevisíveis.

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]
Cabeçalho	Commctrl.h