WM_GETDLGCODE mensagem

  • Artigo

Enviado para o procedimento de janela associado a um controle . Por padrão, o sistema manipula todas as entradas de teclado para o controle; o sistema interpreta determinados tipos de entrada de teclado como teclas de navegação da caixa de diálogo. Para substituir esse comportamento padrão, o controle pode responder à mensagem WM_GETDLGCODE para indicar os tipos de entrada que deseja processar.

#define WM_GETDLGCODE                   0x0087

Parâmetros

wParam

A tecla virtual, pressionada pelo usuário, que levou o Windows a emitir essa notificação. O manipulador deve lidar seletivamente com essas chaves. Por exemplo, o manipulador pode aceitar e processar VK_RETURN mas delegar VK_TAB à janela do proprietário. Para obter uma lista de valores, consulte Códigos de chave virtual.

lParam

Um ponteiro para uma estrutura MSG (ou NULL se o sistema estiver executando uma consulta).

Valor retornado

O valor retornado é um ou mais dos valores a seguir, indicando qual tipo de entrada o aplicativo processa.

Código/valor de retorno Descrição
DLGC_BUTTON
0x2000
 Botão.
DLGC_DEFPUSHBUTTON
0x0010
 Botão de push padrão.
DLGC_HASSETSEL
0x0008
 EM_SETSEL mensagens.
DLGC_RADIOBUTTON
0x0040
 Botão de opção.
DLGC_STATIC
0x0100
 Controle estático.
DLGC_UNDEFPUSHBUTTON
0x0020
 Botão de push não padrão.
DLGC_WANTALLKEYS
0x0004
 Todas as entradas de teclado.
DLGC_WANTARROWS
0x0001
 Teclas de direção.
DLGC_WANTCHARS
0x0080
 WM_CHAR mensagens.
DLGC_WANTMESSAGE
0x0004
 Todas as entradas de teclado (o aplicativo passa essa mensagem na estrutura MSG para o controle).
DLGC_WANTTAB
0x0002
 Tecla TAB.

Comentários

Embora a função DefWindowProc sempre retorne zero em resposta à mensagem WM_GETDLGCODE , o procedimento de janela para as classes de controle predefinidas retorna um código apropriado para cada classe.

A mensagem WM_GETDLGCODE e os valores retornados são úteis apenas com controles de caixa de diálogo definidos pelo usuário ou controles padrão modificados pela subclasse.

Requisitos

Requisito Valor
Cliente mínimo com suporte
 Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
 Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho
Winuser.h (inclua Windows.h)

Confira também

Referência

DefWindowProc

EM_SETSEL

MSG

WM_CHAR

Conceitual

Caixas de diálogo