Compartilhar via


Mensagem WM_CHARTOITEM

Enviado por uma caixa de listagem com o estilo LBS_WANTKEYBOARDINPUT ao seu proprietário em resposta a uma mensagem WM_CHAR.

WM_CHARTOITEM

    WPARAM wParam;
    LPARAM lParam; 

Parâmetros

wParam

O LOWORD especifica o código de caractere da tecla que o usuário pressionou. O HIWORD especifica a posição atual do sinal de interpolação.

lParam

Identificador para a caixa de listagem.

Valor retornado

O valor retornado especifica a ação executada pelo aplicativo em resposta à mensagem. Um valor retornado de -1 ou -2 indica que o aplicativo lidou com todos os aspectos da seleção do item e não requer ação adicional pela caixa de listagem. Um valor retornado igual a 0 ou superior especifica o índice baseado em zero de um item na caixa de listagem e indica que a caixa de listagem deve executar a ação padrão para o pressionamento de tecla no item especificado.

Comentários

A função DefWindowProc retorna -1.

Somente caixas de listagem desenhadas pelo proprietário que não têm o estilo LBS_HASSTRINGS podem receber essa mensagem.

Se um procedimento de caixa de diálogo manipula essa mensagem, ele deve converter o valor de retorno 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 (inclui Windows.h)

Confira também

Referência

WM_VKEYTOITEM

Outros recursos

DefWindowProc

HIWORD

LOWORD

WM_CHAR