WM_COMPAREITEM mensagem

  • Artigo

Enviado para determinar a posição relativa de um novo item na lista classificada de uma caixa de combinação ou caixa de listagem desenhada pelo proprietário. Sempre que o aplicativo adiciona um novo item, o sistema envia essa mensagem ao proprietário de uma caixa de combinação ou caixa de listagem criada com o estilo CBS_SORT ou LBS_SORT .

WM_COMPAREITEM

    WPARAM wParam;
    LPARAM lParam;

Parâmetros

wParam

Especifica o identificador do controle que enviou a mensagem WM_COMPAREITEM .

lParam

Ponteiro para uma estrutura COMPAREITEMSTRUCT que contém os identificadores e os dados fornecidos pelo aplicativo para dois itens na caixa de combinação ou lista.

Valor retornado

O valor retornado indica a posição relativa dos dois itens. Pode ser qualquer um dos valores mostrados na tabela a seguir.

Código de retorno Descrição
Valor
 Significado
-1
 O item 1 precede o item 2 na ordem classificada.
0
 Os itens 1 e 2 são equivalentes na ordem classificada.
1
 O item 1 segue o item 2 na ordem classificada.

Comentários

Quando o proprietário de uma caixa de combinação ou caixa de listagem desenhada pelo proprietário recebe essa mensagem, o proprietário retorna um valor que indica qual dos itens especificados pela estrutura COMPAREITEMSTRUCT será exibido antes do outro. Normalmente, o sistema envia essa mensagem várias vezes até determinar a posição exata do novo item.

Se um procedimento de caixa de diálogo manipular essa mensagem, ele deverá converter o valor retornado desejado em um BOOL e retornar o valor diretamente. O valor DWL_MSGRESULT definido pela função SetWindowLong é ignorado.

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
Winuser.h (inclua Windows.h)

Confira também

Referência

COMPAREITEMSTRUCT

Outros recursos

Setwindowlong