IsDialogMessage

O IsDialogMessage função determina se uma mensagem é destinada a caixa de diálogo especificado e, se for, processa a mensagem.

 (BOOL IsDialogMessage HWND  hDlg, / / identificador da caixa de diálogoLPMSGlpMsg / / endereço da estrutura com mensagem);
 

Parâmetros

hDlg
Identifica a caixa de diálogo.
lpMsg
Ponteiro para um MSG estrutura que contém a mensagem a ser verificado.

Retornar valores

Se a mensagem tiver sido processada, o valor de retorno é diferente de zero.

Se a mensagem não foi processada, o valor de retorno é zero.

Observações

Embora o IsDialogMessage função destina-se a caixas de diálogo sem janela restrita, você pode usá-lo com qualquer janela que contém controles, permitindo que o windows fornecer a mesma seleção de teclado que é usado em uma caixa de diálogo.

Quando IsDialogMessage processa uma mensagem, ele verifica se há mensagens de teclado e converte-los em comandos de seleção para a caixa de diálogo correspondente. Por exemplo, a tecla tab, quando pressionada, seleciona o Avançar controle ou AAgruparar de controles e a tecla de seta para baixo, quando pressionada, seleciona o próximo controle em um grupo.

Porque o IsDialogMessage função executa todas as convertendo necessárias e envio de mensagens, uma mensagem processada pelo IsDialogMessage não deve ser passada para o TranslateMessage ou DispatchMessage função.

IsDialogMessage envia WM_GETDLGCODE mensagens para o procedimento caixa de diálogo para determinar quais teclas devem ser processadas.

IsDialogMessage pode enviar DM_GETDEFID e DM_SETDEFID mensagens para a janela. Essas mensagens são definidas no WINUSER.Arquivo de cabeçalho h como WM_USER e WM_USER + 1, conflitos assim são possíveis com mensagens definido pelo aplicativo ter os mesmos valores.

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.
Biblioteca de importação:Use user32.lib.
Unicode:Implementado como versões Unicode e ANSI no Windows NT.

Ver também

Visão geral de caixas de diálogo, funções de caixa de diálogo, DispatchMessage, DM_GETDEFID, DM_SETDEFID, MSG, TranslateMessage, WM_GETDLGCODE, WM_USER

Index