ListView_SortItems macro (commctrl.h)

Artigo
10/24/2024

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

BOOL ListView_SortItems(
   HWND         hwndLV,
   PFNLVCOMPARE _pfnCompare,
   LPARAM       _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.

Valor de retorno

Tipo: BOOL

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

Observações

A função de comparação tem o formulário a seguir.

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

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. Estes são os valores especificados no lParam membro da estrutura de LVITEM dos itens quando eles foram inseridos na lista. O parâmetro _lPrm é o mesmo valor passado para a mensagem LVM_SORTITEMS.

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 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, os resultados serão imprevisíveis.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	commctrl.h

Compartilhar via