WM_COMPAREITEM mensagem
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 |
|---|---|
|
Significado |
|
O item 1 precede o item 2 na ordem classificada. |
|
Os itens 1 e 2 são equivalentes na ordem classificada. |
|
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 |
|
Confira também
-
Referência
-
Outros recursos