WM_COMPAREITEM

O sistema envia a mensagem WM_COMPAREITEM para determinar o relativo posição de um novo item na lista classificada de uma caixa lista ou caixa de combinação owner-drawn. Sempre que o aplicativo adiciona um novo item, o sistema envia esta mensagem para o proprietário de uma caixa de combinação ou caixa de listagem criado com o estilo CBS_SORT ou LBS_SORT.

 WM_COMPAREITEM idCtl = wParam;                       / / controle identificador lpcis = lParam (LPCOMPAREITEMSTRUCT); / / estrutura com itens

Parâmetros

idCtl: Valor de wParam. Especifica o identificador do Controlarar que enviou a mensagem WM_COMPAREITEM.
lpcis: Valor de lParam. Ponteiro para uma estrutura COMPAREITEMSTRUCT que contém os identificadores e dados application-supplied para dois itens na caixa de combinação ou lista.

Retornar valores

O valor de retorno indica o relativo posição dos dois itens. Pode ser qualquer um dos seguintes:

Valor	Significado
– 1	Precede de item 1 item 2 na ordem de classificação.
0	Itens 1 e 2 são equivalentes na ordem de classificação.
1	Rubrica 1 segue o item 2 na ordem de classificação.

Observações

Quando o proprietário de uma caixa de combinação owner-drawn ou caixa de listagem recebe essa mensagem, o proprietário retorna um valor que indica qual dos itens especificados pela estrutura COMPAREITEMSTRUCT aparecerá antes do outro. Normalmente, o sistema envia esta mensagem várias vezes até que ela determina a posição exata para o novo item.

Se um procedimento caixa de diálogo trata esta mensagem, ela deve cast o valor de retorno desejado para um BOOL e retornar o valor diretamente. O valor DWL_MSGRESULT definido pelo SetWindowLong função é ignorado.

QuickInfo

nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Requer versão 1.0 ou posterior.
Cabeçalho:Declarado em WinUser. h.

Ver também

Visão geral de caixas de combinação, as mensagens de caixa de combinação, COMPAREITEMSTRUCT

Index